feat: versioning scripts — next→latest→archive model#231
Open
feat: versioning scripts — next→latest→archive model#231
Conversation
- version-manager.js: remove Google Sheets/EIP code; implement next → latest → archive model with URL-aware perl link rewriting and noindex/canonical injection - tag-archived.js: new standalone script to retroactively inject noindex + canonical front matter into existing archived directories, per-product and per-version - README.md: full runbook documenting the three-tier model, freeze process, tag-archived usage, noindex convention, and link-rewriting approach Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…→ archived) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Tag next nav entry with 'Unreleased' instead of hidden: true - Strip noindex/canonical from files when next/ is promoted to latest/ - Inject noindex + canonical (pointing to latest/) into next/ pages after each freeze so new pages are protected from crawlers
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.
Summary
version-manager.jsto use anext → latest → archivemodel instead of the oldnext → v0.xsnapshot approachtag-archived.js— standalone utility to retroactively injectnoindex/canonicalinto existing archived version directorieslatest (tag: Latest)→next (tag: Unreleased)→ stable archived (newest first)latest/nav entry shows the human-readable version number (e.g.v0.54) while page paths stay under<product>/latest/noindex/canonicalfrom files promoted tolatest/, re-injects intonext/after each freezeFreeze flow
latest/→<version>/(inject noindex + canonical pointing tolatest/)next/→latest/(strip noindex from promoted files, rewrite internal links)next/pagesdocs.jsonnav andversions.jsonregistryTest plan
cd scripts/versioning && npm run freezeagainst a product with an existinglatest/directorynoindex: true+canonicalin front matterlatest/has nonoindexafter promotionnext/hasnoindex: trueafter freezedocs.json:latest [Latest]→next [Unreleased]→ archivednode tag-archived.js --product sdk --version v0.47 --dry-runto test retroactive tagging