docs: improve readme (#357)

Co-authored-by: Cian Johnston <cian@coder.com>
Co-authored-by: Muhammad Atif Ali <atif@coder.com>

Author: 3 people

.github/workflows/ci.yaml

@@ -57,8 +57,8 @@ jobs:
         with:
           go-version: "~1.22"
 
-      - name: Generate docs
-        run: make docs
+      - name: Generate env vars docs
+        run: make docs/env-variables.md
 
       - name: Check for unstaged files
         run: git diff --exit-code

Makefile

@@ -36,7 +36,7 @@ update-golden-files: .gen-golden
 	go test ./options -update
 	@touch "$@"
 
-docs: options/options.go options/options_test.go
+docs/env-variables.md: options/options.go options/options_test.go
 	go run ./scripts/docsgen/main.go
 
 .PHONY: test