You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Update Trusted Server documentation across all surfaces for the August 2026 release.
A full-surface audit (VitePress site, root/crate markdown, in-code docs, config templates) found systemic drift: fabricated/dead content (nonexistent endpoints, Equativ, removed config keys), incomplete references (5 of 15 Settings sections undocumented, 7 of 14 integrations missing from the overview), missing coverage (no Cloudflare/Spin/Axum deployment guides, no telemetry/tsjs/EdgeZero pages, 7 of 10 crates without READMEs), publishing hygiene (75 internal spec/plan files published to the public site, sensitive values in fastly.toml), and zero CI enforcement of doc correctness.
Design spec: docs/superpowers/specs/2026-08-19-documentation-refresh-design.md (PR #1049, branch spec-docs-refresh), including per-surface source-of-truth map, full audit finding index with file:line citations, and ground-truth inventories (routes, config sections, integration capability matrix, CLI tree).
Work packages (all land in PR #1049 together with the spec, one commit per package)
WP8: Enforcement (docs build on PRs, cargo doc -D warnings in CI, doctests actually running, dependabot gaps)
Absorbed issues
PR #1049 also resolves #277 (nonexistent .with_asset in integration docs, folded into WP2) and #341 (script_guard coverage in the integration guide, folded into WP5).
Done when
Every endpoint, config key, command, and code path named in documentation exists in code on main, with adapter-specific availability stated.
Every shipped surface is documented: all 14 integration IDs, 15 config sections, 4 deployment targets, all ts commands, telemetry, tsjs.
The public docs site publishes only intended pages; no sensitive real-world values remain in tracked config.
CI fails on dead docs links, broken intra-doc links, and failing doctests.
Description
Update Trusted Server documentation across all surfaces for the August 2026 release.
A full-surface audit (VitePress site, root/crate markdown, in-code docs, config templates) found systemic drift: fabricated/dead content (nonexistent endpoints, Equativ, removed config keys), incomplete references (5 of 15
Settingssections undocumented, 7 of 14 integrations missing from the overview), missing coverage (no Cloudflare/Spin/Axum deployment guides, no telemetry/tsjs/EdgeZero pages, 7 of 10 crates without READMEs), publishing hygiene (75 internal spec/plan files published to the public site, sensitive values infastly.toml), and zero CI enforcement of doc correctness.Design spec:
docs/superpowers/specs/2026-08-19-documentation-refresh-design.md(PR #1049, branchspec-docs-refresh), including per-surface source-of-truth map, full audit finding index with file:line citations, and ground-truth inventories (routes, config sections, integration capability matrix, CLI tree).Work packages (all land in PR #1049 together with the spec, one commit per package)
srcExclude, CNAME,fastly.tomlsensitive values, empty/guide/page, slash-command/PR-template gate alignment)RequestWrapper, GAM/Kargo pages, auction README rot,FAQ_POC.md, CHANGELOG/.env.examplerepairs)trusted-server.example.toml+configuration.mdparity with all 15Settingssections and 14 integration configs)adserver_mock; un-orphan real integration pages;TESTING.mdrewrite)platform/docs, crate headers, key module docs, tsjs JSDoc)cargo doc -D warningsin CI, doctests actually running, dependabot gaps)Absorbed issues
PR #1049 also resolves #277 (nonexistent
.with_assetin integration docs, folded into WP2) and #341 (script_guard coverage in the integration guide, folded into WP5).Done when
main, with adapter-specific availability stated.tscommands, telemetry, tsjs.Affected area
Documentation