Skip to content

docs(verification): delete deprecated canonical-campaign sections (closes #4380)#4393

Open
bokelley wants to merge 2 commits into
mainfrom
claude/issue-4380-aao-verified-docs-cleanup
Open

docs(verification): delete deprecated canonical-campaign sections (closes #4380)#4393
bokelley wants to merge 2 commits into
mainfrom
claude/issue-4380-aao-verified-docs-cleanup

Conversation

@bokelley
Copy link
Copy Markdown
Contributor

Summary

PR #4387 rewrote the front-of-page framing for (Sandbox) and left the deprecated canonical-campaign content under a Warning banner pending this follow-up sweep. This PR deletes the banner and the ~100 lines of content it gated:

  • Webhook ownership + the `attestation_verifier`-scoped consent requirement (compliance webhook displacement).
  • Two discovery paths for (Live) — Path A Greenfield and Path B (B1 polling-only, B2 webhook-attached).
  • What the compliance engine observes for (Live) — the eight-check table (Liveness, Freshness, Plausibility, Filter correctness, Reporting-surface cross-consistency, Lifecycle correctness, Introspection consistency, Seller-initiated state transitions).
  • Why continuous observability for (Live) — four-bullet rationale.
  • Anti-teach-to-test alignment subsection that hung off (Live); the page-level reference at `conformance#anti-teach-to-test` is untouched.
  • Maintenance windows declaration block (only meaningful for a rolling-window engine).
  • The multi-subscriber `reporting_webhook` supporting issue paragraph — anchored to brownfield (Live) enrollment; gone with the section.
  • The `attestation_verifier` scope cross-link in "Relationship to other surfaces" — described as the scope granted to the compliance engine for (Live) observation; no longer load-bearing.

What stays

Per the issue scope, kept untouched:

Out of scope

The mid-page sections (Mark semantics, Per-version badges, Display, Registry filter, brand.json enrichment) still use `(Live)` / `'live'` terminology rather than the new `(Sandbox)` qualifier. That's a separate consistency sweep — the issue scope here is deletion, not rename. The underlying wire-format value (`verification_modes: 'live'` in the JWT and `/api/registry` API) hasn't been renamed yet either, so the JSON examples are accurate to what the API returns today.

Test plan

  • `git diff --stat` — only `docs/building/verification/aao-verified.mdx` changed, 100 deletions.
  • `npm run precommit` — all unit tests, lint, and typecheck green (deletion only).
  • Manually walked headings post-cut: 14 `##` sections, no orphaned anchor refs.

Closes #4380.

🤖 Generated with Claude Code

bokelley and others added 2 commits May 11, 2026 08:21
…oses #4380)

Removes the ~100 lines that sat behind the Warning banner on
docs/building/verification/aao-verified.mdx:

- Webhook ownership + attestation_verifier consent requirement
- Two discovery paths (Path A Greenfield, Path B Brownfield)
- Eight-check observability table
- Why continuous observability
- Anti-teach-to-test alignment subsection (the page-level
  reference at conformance#anti-teach-to-test is untouched)
- Maintenance windows
- Multi-subscriber reporting_webhook supporting issue (was anchored
  to brownfield Live enrollment, no longer load-bearing)
- attestation_verifier scope cross-link in "Relationship to other
  surfaces" (anchored to Live observation, gone with the section)

Kept per the issue scope: badge mark visuals, JWT envelope, registry
surfaces (SVG/embed/registry-filter/brand.json), Naming history
(historical compatibility table), eligibility, revocation, mark
semantics, deferred (Live) supporting-issues paragraph.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Docs-only — no version bump.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: refresh aao-verified.mdx + conformance.mdx + comply-test-controller.mdx for (Sandbox) framing

1 participant