docs: improve development workflow

Makefile

@@ -0,0 +1,20 @@
+
+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 suite.
+	go test ./...
+
+##@analysis
+vet: ##@analysis Run Go vet.
+	go vet ./...
+
+##@documentation
+generate: ##@documentation Regenerate the documentation.
+	go -C docs run ./readme/main.go
+
+docs-watch: ##@documentation Watch source changes and regenerate documentation.
+	sh docs/watcher.sh

README.md

@@ -84,11 +84,9 @@ They are compiled and executed in CI to ensure the documentation stays accurate
 
 httpx v1 has been tagged and is now frozen. The current module path is `github.com/goforj/httpx/v2`, and the `main` branch includes intentional breaking changes to improve API clarity and ergonomics (for example, request helpers return `(T, error)`).
 
-## Contributing
+## Development
 
-- Run `go run ./docs/examplegen/main.go` after updating doc examples.
-- Run `go run ./docs/readme/main.go` to refresh the API index and test count.
-- Run `go test ./...`.
+Use `make test` for the test suite, `make vet` for static checks, and `make generate` to refresh generated documentation. Keep examples and documentation accurate with behavior changes.
 
 <!-- api:embed:start -->