chore: snapshot docs for v3.0.21#5907
Merged
Merged
Conversation
bokelley
enabled auto-merge (squash)
July 18, 2026 20:02
There was a problem hiding this comment.
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
addedexceptdocs.json(modified).scripts/check-immutable-release-artifacts.cjsonly fires when a versioneddist/**path existed at base AND carries a release tag;3.0.21is new, soexistedAtBaseis false and adding it is permitted. No3.0.20files touched. - Nav retarget is a pure version bump. Base
docs.json:75points the "3.0" version atdist/docs/3.0.20/*; head points it atdist/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:88resolves every page ref to a.mdx/.mdon disk, and L131-142 enforces a single version prefix per version (catches a stray3.0.20left 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/**anddocs.jsononly — none ofstatic/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)
docs.jsonrenders 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 clean3.0.20→3.0.21prefix 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.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Replacement for #5799, regenerated on current main after the v3.0.20 and v3.1.1–v3.1.3 snapshots merged.
Validation: release-docs navigation tests (5 passed), full docs navigation validation (21 passed), and git diff --check.