Skip to content

fix(sidebar): wire generated reference pages into navigation - #26

Merged
joshsmithxrm merged 2 commits into
mainfrom
fix/sidebar-reference-autogen
Apr 25, 2026
Merged

fix(sidebar): wire generated reference pages into navigation#26
joshsmithxrm merged 2 commits into
mainfrom
fix/sidebar-reference-autogen

Conversation

@joshsmithxrm

Copy link
Copy Markdown
Owner

Summary

  • Switch Reference subcategories (CLI, Libraries, MCP) from manual item lists to autogenerated so all 532 generated pages show up in the sidebar
  • Add Extension category (was generated but missing from sidebar entirely)
  • Rename _index.md to api-reference.md (Docusaurus ignores _ prefixed files)
  • Overview pages become category landing links

Test Plan

  • npm run build passes locally
  • Verified sidebar renders all four surfaces (CLI, Extension, Libraries, MCP)
  • Verified MCP tools expandable in sidebar
  • Verified individual tool pages render correctly

- Switch Reference subcategories (CLI, Libraries, MCP) from manual item
  lists to autogenerated sidebar items so all generated pages are
  discoverable
- Add Extension category (was generated but missing from sidebar)
- Rename _index.md → api-reference.md (Docusaurus ignores _ prefixed files)
- overview.md pages become category landing links

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request updates the sidebar configuration to use category landing links and autogenerated items for the CLI, Libraries, and MCP sections, while also introducing a new Extension category. Feedback was provided regarding the missing landing link for the Extension category to maintain consistency with other sections. Additionally, a potential issue was identified where overview pages might appear twice in the sidebar due to the combination of category links and autogenerated directory items.

Comment thread sidebars.ts Outdated
Comment thread sidebars.ts Outdated
- Rename overview.md → index.md so Docusaurus uses them as category
  landing pages without duplication in the sidebar
- Simplify sidebar to single autogenerated directive for reference/
- Update all internal links from /overview to directory paths
- Update footer link in docusaurus.config.ts

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@joshsmithxrm
joshsmithxrm merged commit 2633cc8 into main Apr 25, 2026
1 check passed
@joshsmithxrm
joshsmithxrm deleted the fix/sidebar-reference-autogen branch April 25, 2026 14:47
@github-project-automation github-project-automation Bot moved this from Todo to Done in PPDS Roadmap Apr 25, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

1 participant