diff --git a/README.md b/README.md
index 7d62985..c84dcc6 100644
--- a/README.md
+++ b/README.md
@@ -5,13 +5,18 @@ This is my Zig text editor. It is very much a work-in-progress, but far enough a
 
 https://github.com/neurocyte/flow/assets/1552770/97aae817-c209-4c08-bc65-0a0bf1f2d4c6
 
+# Building
+
 Build with the provided zig wrapper:
 ```shell
 ./zig build -Doptimize=ReleaseFast
 ```
 
 The zig wrapper just fetches a known good version of zig nightly and places it
-in the .cache directory. Or use your own version of zig.
+in the .cache directory. Or use your own version of zig. Be sure to use a version
+at least as high as the version used be the zig wrapper. It's stored in `build.zig.version`.
+
+Also, make sure your system meets the requirements listed below.
 
 Run with:
 ```shell
@@ -22,13 +27,13 @@ Place it in your path for convenient access.
 
 See --help for full command line.
 
-requirements:
+# Requirements
 - A modern terminal with 24bit color and kitty keyboard protocol support (kitty and ghostty are the only recommended terminals at this time)
 - NerdFonts support
 - Linux or MacOS (help porting to *BSD or Windows is welcome!)
 - A UTF-8 locale (very important!)
 
-features:
+# Features
 - fast TUI interface. no user interaction should take longer than one frame (6ms) (even debug builds)
 - tree sitter based syntax highlighting
 - multi cursor editing support
@@ -41,7 +46,7 @@ features:
 - infinite undo/redo (at least until you run out of ram)
 - stuff I've forgotten to mention...
 
-features in progress:
+# Features in progress
 - LSP support for linting and navigating
 - find in files
 - multi tty support (shared editor sessions across multiple ttys)
@@ -49,6 +54,6 @@ features in progress:
 - completion UI
 - persistent undo/redo
 
-features planned:
+# Features planned for the future
 - multi host editing
 - multi user editing