Skip to content

Conversation

@bokelley
Copy link
Contributor

Summary

Updates the sync-versioned-docs workflow to automatically sync navigation config from 2.6.x's docs.json to main's v2.6-rc version.

Problem

When new sections (like governance) are added on 2.6.x, the docs files get synced but the navigation config in main's docs.json had to be manually updated - causing missing sidebar entries.

Solution

The workflow now:

  1. Extracts navigation groups from 2.6.x's docs.json (the "2.5" version which has the actual content)
  2. Transforms all paths by prepending v2.6-rc/
  3. Updates main's docs.json with the transformed navigation for the 2.6-rc version

Dependencies

Test plan

  • jq transformation tested locally
  • YAML validation passes
  • Run workflow manually after merge to verify

🤖 Generated with Claude Code

The sync workflow now extracts navigation groups from 2.6.x's docs.json,
transforms paths by prepending "v2.6-rc/", and updates main's docs.json.

This ensures new sections (like governance) automatically appear in v2.6-rc
navigation without manual docs.json updates on main.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@bokelley bokelley merged commit 9308770 into main Jan 20, 2026
6 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.

1 participant