Skip to content

docs: publish versioned documentation#285

Merged
juelg merged 2 commits intomasterfrom
fix/docs-version-switcher
Apr 23, 2026
Merged

docs: publish versioned documentation#285
juelg merged 2 commits intomasterfrom
fix/docs-version-switcher

Conversation

@juelg
Copy link
Copy Markdown
Contributor

@juelg juelg commented Apr 23, 2026

Summary

  • build and deploy a versioned docs site instead of only the latest master snapshot
  • keep latest at the site root while adding release snapshots for tags that actually contain docs
  • make the docs switcher and displayed release value derive from the build context instead of a hardcoded version

Notes

  • historical release docs are included only for tags that contain docs/conf.py
  • today that means the switcher exposes 0.6.0 through 0.6.3 plus latest

Validation

  • local dry run of scripts/build_versioned_docs.py with RCS_DOCS_TAGS=v0.6.3,v0.6.2
  • verified generated site layout contains /, /latest/, /0.6.3/, and /0.6.2/
  • verified older tags without a docs tree are skipped

@juelg juelg force-pushed the fix/docs-version-switcher branch from 9d797b7 to eb88f7b Compare April 23, 2026 07:41
@juelg juelg force-pushed the fix/docs-version-switcher branch from eb88f7b to 68e6614 Compare April 23, 2026 07:53
@juelg juelg force-pushed the fix/docs-version-switcher branch from 68e6614 to 3ff544d Compare April 23, 2026 07:54
@juelg juelg merged commit 07b7e64 into master Apr 23, 2026
4 checks passed
@juelg juelg deleted the fix/docs-version-switcher branch April 23, 2026 07:57
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.

1 participant