docs: improve development workflow

Makefile

@@ -0,0 +1,28 @@
+
+HELP_FUN = %help; while (<>) { /^([A-Za-z0-9_-]+)\s*:.*\#\#(?:@([A-Za-z0-9_-]+))?\s(.*)$$/ or next; push @{$$help{$$2 || "other"}}, [$$1, $$3]; $$width = length($$1) if length($$1) > $$width } print "\e[1;97m$(or $(HELP_NAME),$(notdir $(CURDIR)))\e[0m\n\n"; for $$category (sort keys %help) { print "\e[1;97m$$category\e[0m\n"; for $$entry (@{$$help{$$category}}) { printf "  \e[1;32m%-*s\e[0m  \e[90m%s\e[0m\n", $$width, $$entry->[0], $$entry->[1] } }
+
+help: ##@other Show this help.
+	@perl -e '$(HELP_FUN)' $(MAKEFILE_LIST)
+
+##@tests
+test: ##@tests Run the test suites.
+	go test ./...
+	go -C docs test ./...
+	go -C examples test ./...
+
+test-race: ##@tests Run the race-enabled test suite.
+	go test -race ./...
+
+##@analysis
+vet: ##@analysis Run Go vet for every module.
+	go vet ./...
+	go -C docs vet ./...
+	go -C examples vet ./...
+
+##@documentation
+generate: ##@documentation Regenerate documentation examples and README content.
+	go -C docs run ./examplegen
+	go -C docs run ./readme
+
+docs-watch: ##@documentation Watch source changes and regenerate documentation.
+	sh docs/watcher.sh

README.md

@@ -1160,14 +1160,6 @@ fmt.Println(out == dir)
 
 `docs` and `examples` are separate Go modules, keeping their tooling and generated programs out of the library module download.
 
-Run the tests and rebuild the generated examples and README with:
-
-```sh
-go test ./...
-go -C docs test ./...
-go -C examples test ./...
-go -C docs run ./examplegen
-go -C docs run ./readme
-```
+Use `make test`, `make test-race`, `make vet`, and `make generate`. The test and vet targets cover all three modules; generation rebuilds the examples and README.
 
 Licensed under the [MIT License](./LICENSE).