From f574665468857662c62cb5dba6f8857f3e43244f Mon Sep 17 00:00:00 2001
From: c+1
Date: Fri, 5 May 2023 17:59:19 -0400
Subject: read me dot em dee

---
 README.md | 27 ++++++++++++++++++++++++++-
 1 file changed, 26 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 43c6907..ee4766f 100644
--- a/README.md
+++ b/README.md
@@ -16,6 +16,31 @@ There is no turning back.
 1. Clone *HALK* to a computer.
 2. `sudo make install`.
 3. Congratulations; You are now part of The.
-3. *you cannot turn back*
+
+# Usage
+
+Seeing as you have installed *HALK*, it only makes sense that you should attempt to make use of it.
+You are mistaken.
+Usage of *HALK* is not yet a feature of *HALK*.
+One can only hope this feature will be added in the future.
+
+
+# Syntax
+
+*HALK* is a **dubiously-typed**, **procedural** programming language. 
+Note that all syntax described is liable to sudden and violent change.
+
+```HALK
+let variable = 4;
+let another_variable = "Hello, World!";
+
+fn main /
+   for variable > 0 /
+      say another_variable;
+      variable -= 1;
+   \
+   say "done.";
+\
+```
 
 ***HALK*** **progress:** 10%
-- 
cgit v1.2.3