feat(makefile): add fix target for in-place formatting

Add `make fix` target to Makefile. Update retrofit guide to use
`make fix` instead of manual docker run. Add fix to target mapping.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: matthew-on-git

Makefile

@@ -6,8 +6,8 @@ HUGO_VERSION  ?= latest
 .DEFAULT_GOAL := help
 
 # .PHONY declarations
-.PHONY: help build serve lint format test security scan docs check install-hooks
-.PHONY: _lint _format _test _security _scan _docs _check
+.PHONY: help build serve lint format fix test security scan docs check install-hooks
+.PHONY: _lint _format _fix _test _security _scan _docs _check
 
 # Public targets
 help: ## Show this help
@@ -23,6 +23,9 @@ serve: ## Start local Hugo development server
 lint: ## Run all linters
 	$(DOCKER_RUN) make _lint
 
+fix: ## Auto-fix formatting issues in-place
+	$(DOCKER_RUN) make _fix
+
 format: ## Run all formatters
 	$(DOCKER_RUN) make _format
 
@@ -52,6 +55,9 @@ _lint:
 _format:
 	@echo "format: no language-specific formatters for documentation site"
 
+_fix:
+	@echo "fix: no language-specific formatters for documentation site"
+
 _test:
 	@echo "test: no language-specific tests for documentation site"
 

content/docs/getting-started/retrofit.md

@@ -104,13 +104,11 @@ Expect some findings on the first run -- your existing code may not match DevRai
 
 ### Fixing Findings
 
-Use `make` targets to auto-fix what can be auto-fixed:
+Use `make fix` to auto-fix formatting issues in-place:
 
 ```bash
-# Auto-format code (inside the container)
-# Note: formatting targets apply fixes directly
-docker run --rm -v "$(pwd):/workspace" -w /workspace \
-  ghcr.io/devrail-dev/dev-toolchain:v1 make _format
+# Auto-fix formatting (runs inside the container)
+make fix
 ```
 
 For linting issues that cannot be auto-fixed, address them manually following the guidance in the [Standards Reference](/docs/standards/).

content/docs/standards/_index.md

@@ -30,7 +30,8 @@ Each Makefile target runs the relevant tools for all languages declared in `.dev
 | Target | What It Runs |
 |---|---|
 | `make lint` | ruff check, shellcheck, tflint, ansible-lint, mypy, rubocop, reek, golangci-lint, eslint, tsc |
-| `make format` | ruff format, shfmt, terraform fmt, rubocop, gofumpt, prettier |
+| `make format` | ruff format --check, shfmt -d, terraform fmt -check, rubocop --check, gofumpt -d, prettier --check |
+| `make fix` | ruff format, shfmt -w, terraform fmt, rubocop -a, gofumpt -w, prettier --write |
 | `make test` | pytest, bats, terratest, molecule, rspec, go test, vitest |
 | `make security` | bandit, semgrep, tfsec, checkov, brakeman, bundler-audit, govulncheck, npm audit |
 | `make scan` | trivy, gitleaks (universal -- all projects) |