Add release-prep audit guidance; document missed 0.15.0 user-visible changes#2619
Merged
chalin merged 2 commits intogoogle:mainfrom Apr 30, 2026
Merged
Conversation
…changes - Adds a "Release-prep audit" section to the maintainer notes — a checklist for inspecting every PR/commit in the release range, classifying changes against Docsy's public customization surface, and verifying changelog + release-blog coverage. Links the audit step from the publishing-a-release flow as the source of truth (motivated by the version-menu changes missed during 0.15.0 prep). - Adds a complementary, non-mandatory "PR descriptions" note encouraging authors to flag the scope of changes (breaking / user-facing / internal-only / docs-only, with optional kinds) for PRs that touch the public surface. - Documents the 0.15.0 version-menu and navigation user-visible changes in the release blog, changelog, and user docs (navigation, versioning) — the changes themselves shipped earlier on this release branch; this PR fills in the missing documentation/release-notes coverage and re-routes the blog's version-menu section to the user-guide pages instead of the PRs. - Flags the `siteGetPage` shortcode (google#2586) as internal to docsy.dev in the 0.15.0 changelog and adds a header comment to the shortcode itself describing its purpose and internal-only status. - Updates 0.15 release-prep task notes (issue-audit, commit-inventory, issue-mapping) to reflect the additional coverage. - Scope: docs-only
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
1 participant
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.
Documents the 0.15.0 version-menu and navigation user-visible changes in the release blog, changelog, and user docs (navigation, versioning) — the changes themselves shipped earlier on this release branch; this PR fills in the missing documentation/release-notes coverage and re-routes the blog's version-menu section to the user-guide pages instead of the PRs.
Adds a "Release-prep audit" section to the maintainer notes — a checklist for inspecting every PR/commit in the release range, classifying changes against Docsy's public customization surface, and verifying changelog + release-blog coverage. Links the audit step from the publishing-a-release flow as the source of truth (motivated by the version-menu changes missed during 0.15.0 prep).
Adds a complementary, non-mandatory "PR descriptions" note encouraging authors to flag the scope of changes (breaking / user-facing / internal-only / docs-only, with optional kinds) for PRs that touch the public surface.
Flags the
siteGetPageshortcode (Update version+variant menu, add siteGetPage shortcode, add tdVersion struct, and more #2586) as internal to docsy.dev in the 0.15.0 changelog and adds a header comment to the shortcode itself describing its purpose and internal-only status.Updates 0.15 release-prep task notes (issue-audit, commit-inventory, issue-mapping) to reflect the additional coverage.
Scope: docs/internal-only