docs: the docs restated the same numbers in five different values

[skyoo2003]

Summary

Eighteen documentation files rewritten for concision — 3,564 lines to 2,501. Most of what came out was narrative that re-argued decisions the tables already state. Along the way the rewrite surfaced six figures published in more than one place with no two places agreeing, and three statements that did not match the code.

Related Issue

Refs #

Changes

Numbers now have one home. Six figures were restated across pages and had drifted apart:

Figure	Was published as	Actual
Services	205 / 148 / 101	205 registered, 201 serving
Operation tiers	12,407 / 9,030 / 7,475	4,497 / 5,193 / 2,717
Compatibility tests	992 / 1,144 / 775	1,144
Services with no Smithy model	11 / 12	11
Engine-wired services	46	155

Only coverage.md, README.md and docs/README.md are gated against the binary by cmd/devcloud/coverage_test.go, so those three were correct and every restatement of them had rotted. coverage.md now owns the numbers and the other pages link to it — the arrangement the gate already assumes.

Three statements corrected against the code:

• troubleshooting.md told readers to check GET /devcloud/api/health. internal/admin/api.go:39-43 registers five routes and health is not one, so the only "is the server up?" command offered returned 404.
• troubleshooting.md blamed a failed Lambda invoke on Docker not running. lambda/runtime.go is a stub whose Invoke unconditionally returns a placeholder payload; no configuration makes it execute a handler.
• contributing.md listed interface.go, serializer.go and deserializer.go as codegen output. There are four templates and none emits those — providers parse *http.Request themselves, which architecture.md already said on the same tree.

crud-engine.md contradicted itself — its protocol table served all five protocols; its Scope section two screens later said JSON-only across 46 services. The Scope section predates rest-json support and is gone.

compatibility-policy.md said 193 model-backed / 12 without. Parsing manifest_gen.go gives 194 / 11 — the figures corrected in #150 were themselves off by one.

services-matrix.md was the worst-drifted page and is now a shape-of-the-surface page that links to coverage.md rather than maintaining a parallel set of counts by hand.

Untouched on purpose: the 285-row evidence table in demand.md (parsed by TestDemandSetIsRegistered, and a record of a sample rather than prose), and docs/services/*.md (already concise).

Files Changed

File	Lines	Change
docs/coverage.md	375 → 261	Modified — milestone narrative removed, gated tables preserved verbatim
docs/demand.md	347 → 337	Modified — prose header only; ranking table untouched
docs/plugin-api.md	204 → 199	Modified
docs/architecture.md	224 → 193	Modified — protocol table corrected (Lambda is rest-json, not JSON 1.1)
docs/contributing.md	231 → 178	Modified — codegen output list corrected
docs/compatibility-policy.md	171 → 161	Modified — 194/11 fix, assertion-scope table
docs/configuration.md	208 → 155	Modified
RELEASE.md	160 → 151	Modified
docs/fidelity-manifest.md	175 → 147	Modified — stale totals removed, now links coverage.md
docs/troubleshooting.md	103 → 102	Modified — health endpoint and Lambda entries corrected
docs/crud-engine.md	139 → 100	Modified — self-contradicting Scope section removed
docs/getting-started.md	110 → 99	Modified
docs/roadmap.md	83 → 84	Modified
README.md	85 → 75	Modified — 992 → 1,144 tests
docs/services-matrix.md	121 → 73	Modified — rewritten to link rather than restate
docs/faq.md	74 → 58	Modified — 148/117 and the "~96% of boto3's official suite" claim removed
docs/README.md	52 → 46	Modified
SUPPORT.md	42 → 39	Modified

Test Plan

• CGO_ENABLED=0 go test ./cmd/... ./internal/config/... — green. All five doc gates pass: TestPublishedCoverageMatchesTheBinary, TestPublishedOperationTiersMatchTheManifest, TestRegisteredOnlyServicesAreNamedInTheDocs, TestOtherDocsQuoteTheSameFigure, TestDemandSetIsRegistered.
• Every relative Markdown link in the tree resolves — checked by walking all .md files and stat-ing each non-anchor target. 0 broken.
• Figures re-derived by parsing internal/generated/fidelity/manifest_gen.go directly (205 services, 194/11 model-backed, 155 engine-wired, 4,497/5,193/2,717 tiers) and by pytest --collect-only (1,144 tests), not by copying from another page.
• No code changed, so lint and the compatibility suite are unaffected.

Checklist

• Self-reviewed the code
• Added/updated tests — N/A, docs only
• Lint/format passes (golangci-lint run) — no Go files changed; pre-commit hooks passed on commit
• Updated documentation (if applicable)
• Added a Changie changelog fragment — added in a follow-up commit on this branch, once the PR number exists