feat(web): add Next docs version snapshot#1613
Merged
Merged
Conversation
Adds a frozen `next` docs archive under /docs/next/ pinned to the v5.0.0-next.1 tag, extending the version-select/sidebar components and snapshot script (previously hardcoded to a single v4.42.4 archive) to support multiple archived versions. Dropdown now shows Canary / Next / v4.42.4. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Deploying agentv with
|
| Latest commit: |
52e001a
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://dbe75d22.agentv.pages.dev |
| Branch Preview URL: | https://versioned-docs.agentv.pages.dev |
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Mirrors the beads docs versioning structure: the bare /docs/ URL now redirects to the latest stable release (v4.42.4) instead of serving a separate "Canary" live tree, and the actual editable doc source moves to /docs/next/ (the live, unreleased tree). Canary is dropped as a concept since it's redundant with Next once Next is the live tree rather than a frozen snapshot. - Move live doc source from content/docs/docs/* into docs/next/* and fix relative asset/example links for the extra nesting level. - astro.config.mjs: sidebar autogenerate directories now point at docs/next/*; redirects generated per-route from the existing docs-v4.42.4-routes.json manifest so every bare /docs/* subpage redirects to its v4.42.4 equivalent (a wildcard redirect isn't supported for static output without enumerable paths). - VersionSelect.astro: drop the Canary option, dropdown is now Next / v4.42.4. - VersionedSidebar.astro: only v4.42.4 needs href remapping now, since the base sidebar (built from docs/next/*) already matches the live tree's routes. - snapshot-docs-version.mjs: snapshots are now cut from the live docs/next/ subtree instead of the docs/ root, and no longer support "next" as a version slug since next is no longer a frozen snapshot. Removes the now-dead asset-path depth rewrite (source and destination are the same depth once cutting from next/). - Remove the frozen next/ snapshot and docs-next-routes.json from the prior commit, and the docs:snapshot:next script. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
The Result Artifact Contract ADR link was broken (lychee link check failure in CI) since result-artifacts.mdx moved to docs/next/ along with the rest of the live doc tree. Also updates other non-historical references (skill READMEs, SDK README, example README, a solutions doc) that pointed at the old pre-move path; docs/plans/* and docs/brainstorms/* are left as-is since those are point-in-time historical artifacts. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
# Conflicts: # apps/web/src/content/docs/docs/next/guides/human-review.mdx # apps/web/src/content/docs/docs/next/guides/workspace-pool.mdx
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
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
nextdocs archive under/docs/next/, pinned to thev5.0.0-next.1tag, alongside the existing Canary (live) andv4.42.4(stable) tiers.VersionSelect.astroandVersionedSidebar.astrofrom a single hardcoded archived version to a list, so future stable releases only need a new snapshot + array entry.scripts/snapshot-docs-version.mjsto acceptnextas a version slug alongsidevX.Y.Ztags, and adds adocs:snapshot:nextscript pinned tov5.0.0-next.1.Docs version dropdown now shows: Canary → Next → v4.42.4.
Test plan
bun run buildinapps/websucceeds and emits/docs/,/docs/next/, and/docs/v4.42.4/pagesbun run preview+ curl verified the version dropdown shows the correct selected option on each tier/docs/next/...only links within/docs/next/(no Canary link leakage)/docs/next//docs/next/evaluation/eval-cases/route resolves (200)🤖 Generated with Claude Code