Skip to content

Versioned documentation with version switcher (#231)#253

Merged
erishforG merged 6 commits intomainfrom
develop
Apr 22, 2026
Merged

Versioned documentation with version switcher (#231)#253
erishforG merged 6 commits intomainfrom
develop

Conversation

@erishforG
Copy link
Copy Markdown
Owner

Summary

  • Add version-switcher dropdown to all docs pages (latest, guide, reference)
  • Create versioned snapshots for all releases (v0.1.1 ~ v0.3.3)
  • Add snapshot-docs CI job to auto-create doc snapshots on each release
  • Add versions.json manifest and sitemap entries for all versions
  • Add CLAUDE.md with project conventions and mandatory pre-release checklist
  • Add .claude/ to .gitignore

Test plan

  • Version dropdown appears on latest docs pages
  • Old version pages show yellow warning banner (except when viewing latest)
  • Subpath preservation works (guide → guide, reference → reference)
  • versions.json valid JSON
  • sitemap.xml valid XML
  • cargo build passes
  • Banner does not overlap with nav bar

Closes #231

🤖 Generated with Claude Code

erishforG and others added 5 commits April 23, 2026 01:08
- Update README with rename, --dry-run, doctor --ai, error codes, policy config, FAQ
- Fix docs site: version 0.3.3, downloadUrl, expanded FAQPage (10 Q&A)
- Add BreadcrumbList and HowTo schemas to guide/reference pages
- Add CHANGELOG.md, sitemap.xml, robots.txt
- Add documentation field to Cargo.toml

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
- Add version-switcher dropdown to all docs pages
- Create versioned snapshots for all releases (v0.1.1 ~ v0.3.3)
- Add snapshot-docs CI job to auto-create snapshots on release
- Add versions.json manifest and sitemap entries
- Add CLAUDE.md with project conventions and release checklist
- Add .claude/ to .gitignore

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
231: docs: versioned documentation on GitHub Pages
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
fix: merge main into develop (resolve sitemap conflict)
@erishforG erishforG merged commit 031a751 into main Apr 22, 2026
16 checks passed
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.

docs: versioned documentation on GitHub Pages

1 participant