Skip to content

chore: snapshot docs for v3.0.21#5907

Merged
bokelley merged 1 commit into
mainfrom
fix-docs-snapshot-3-0-21
Jul 18, 2026
Merged

chore: snapshot docs for v3.0.21#5907
bokelley merged 1 commit into
mainfrom
fix-docs-snapshot-3-0-21

Conversation

@bokelley

Copy link
Copy Markdown
Contributor

Replacement for #5799, regenerated on current main after the v3.0.20 and v3.1.1–v3.1.3 snapshots merged.

  • adds the immutable dist/docs/3.0.21 snapshot from the original release tag
  • updates the existing 3.0 navigation entry to 3.0.21 without removing newer snapshots
  • preserves every already-merged release snapshot

Validation: release-docs navigation tests (5 passed), full docs navigation validation (21 passed), and git diff --check.

@bokelley
bokelley enabled auto-merge (squash) July 18, 2026 20:02

@aao-secretariat aao-secretariat Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Clean release-train snapshot. Additive-only: 377 new files under dist/docs/3.0.21/ plus a navigation retarget in docs.json — no existing snapshot is mutated, so the immutable-artifact invariant holds.

Things I checked

  • Nothing existing is edited. Every file in the diff is added except docs.json (modified). scripts/check-immutable-release-artifacts.cjs only fires when a versioned dist/** path existed at base AND carries a release tag; 3.0.21 is new, so existedAtBase is false and adding it is permitted. No 3.0.20 files touched.
  • Nav retarget is a pure version bump. Base docs.json:75 points the "3.0" version at dist/docs/3.0.20/*; head points it at dist/docs/3.0.21/*. That is the entire 306-deletion delta — path prefixes, not structure.
  • Nav integrity — no dangling refs. The one way a snapshot PR breaks is a nav entry pointing at a file that wasn't added. tests/docs-nav-validation.test.cjs:88 resolves every page ref to a .mdx/.md on disk, and L131-142 enforces a single version prefix per version (catches a stray 3.0.20 left in the block). Spot-checked 9 targets spanning every top-level section (building/schemas-and-sdks, building/verification/aao-verified, registry/index, creative/task-reference/build_creative, governance/campaign/tasks/check_governance, sponsored-intelligence/tasks/si_get_offering, trusted-match/surfaces/ai-assistants, media-buy/task-reference/get_products, reference/versions) — all present as added files.
  • No changeset required. Diff touches dist/docs/** and docs.json only — none of static/schemas/source/**, mintlify-docs/reference/**, docs/reference/**, or build scripts. No wire surface, no versioning-tracked change.
  • Decision class: Editorial (release-train metadata + immutable snapshot copied from the release tag). Replacement for #5799, regenerated on current main after the v3.0.20 / v3.1.1–v3.1.3 snapshots merged; newer snapshots preserved.

Minor nits (non-blocking)

  1. docs.json renders as +0/-0 on the API. The patch is omitted for size, so the retarget isn't reviewable from the PR files view — I diffed base vs head refs directly to confirm it's a clean 3.0.203.0.21 prefix swap. Nothing to fix; noting it so the next reviewer doesn't read the empty patch as "no change."

Nav validation is the load-bearing gate here and it covers the only real failure mode. Snapshot is additive, immutability preserved.

LGTM.

@bokelley
bokelley merged commit 70d4a2e into main Jul 18, 2026
17 checks passed
@bokelley
bokelley deleted the fix-docs-snapshot-3-0-21 branch July 18, 2026 20:08
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.

1 participant