From 36f5bf1dfcef9d3bf4981cf38503c02ded16cf55 Mon Sep 17 00:00:00 2001
From: Joshua Potter <jrpotter2112@gmail.com>
Date: Sun, 26 Nov 2023 06:39:41 -0700
Subject: [PATCH] Flesh out development section of README.

---
 Makefile  |  3 +++
 README.md | 30 ++++++++++++++++++++----------
 2 files changed, 23 insertions(+), 10 deletions(-)

diff --git a/Makefile b/Makefile
index 0a69287..a49458a 100644
--- a/Makefile
+++ b/Makefile
@@ -8,6 +8,9 @@ build: include/*.h src/*.c
 bear: include/*.h src/*.c
 	@bear -- ${BUILD}
 
+docs:
+	doxygen
+
 test: test/test
 	$^
 
diff --git a/README.md b/README.md
index 24f761e..8030d46 100644
--- a/README.md
+++ b/README.md
@@ -113,10 +113,11 @@ field and writes the prompt `"Prompt for field> "` to `stdout`. Since
 `"fieldname"` has type `"text"`, `bootstrap` will wait for the user to input
 a string (submitted with a newline).
 
-If the user were to enter, say `fieldvalue`, in response to the prompt,
-the `runner` script would then have access to an environment variable
-`FIELDNAME` set to `fieldvalue` on launch. Field names should consist of
-alphanumeric characters or underscores, and may not start with a digit.
+If the user were to enter `fieldvalue` in response to the prompt, the `runner`
+script would then have access to an environment variable `FIELDNAME` set to
+`fieldvalue`. Field names should respect the [POSIX standard](https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap08.html)
+on environment variable naming. In particular, all field names consist solely
+of alphanumeric characters or underscores and cannot start with a digit.
 
 #### Types
 
@@ -169,20 +170,29 @@ this.
 
 ## Development
 
-TODO
+Keep in mind this tool was originally written for personal usage and as such,
+any functionality (or lack thereof) reflects my own needs as I have come across
+them.
 
 ### Documentation
 
-TODO
+We use [doxygen](https://www.doxygen.nl/index.html) for documentation
+generation. Run either of the following two commands to generate documentation
+locally:
+```bash
+$> make docs
+$> doxygen
+```
 
 ### Formatting
 
-A `pre-commit` file is included in `.githooks` to ensure consistent formatting.
-Run the following to configure `git` to use it:
+We use `clang-format` to ensure consistent formatting. A `pre-commit` file is
+included in `.githooks` to enforce usage. Run the following to configure `git`
+to use it:
 
 ```bash
 git config --local core.hooksPath .githooks/
 ```
 
-If running [direnv](https://direnv.net/), this is done automatically if `git` is
-installed.
+If running [direnv](https://direnv.net/), this is done automatically upon
+entering the project directory.