Restructure documentation navigation (Phase 1)#551
Merged
Conversation
Rename all "Guides: X" sidebar labels to just "X" for cleaner navigation. Also rename "Guides: MCP server usage" to "MCP server guides". Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Each product section now has its quickstart as the first child item (or after the intro page for sections that have one). The top-level "Get started" category is removed. Quickstart sidebar labels shortened to just "Quickstart" since the section provides context. Also removes the now-broken quickstart-vmcp and link to the old generated-index from the Tutorials category, since those items have moved to their product sections. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Rename "Custom permissions" category to "Permissions and security". Create new "Advanced workflows" category grouping auth, token exchange, telemetry, test, build, CI/CD, custom registry, and API server. These are multi-user or builder-focused topics that don't belong in the core single-user workflow. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Move authentication and token exchange before telemetry and logging in the Kubernetes Operator sidebar. Security is a core enterprise concern that belongs earlier in the workflow. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Add the intro page as the first explicit child item (labeled "Introduction" in sidebar). Move deployment up to right after the introduction -- the natural flow is understand → deploy → configure, not configure → deploy. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Replace the standalone Tutorials sidebar category with a new Integrations section containing the cross-cutting integration guides (OpenTelemetry, HashiCorp Vault, ngrok ingress). Update navbar link accordingly. Quickstarts already moved to product sections. Custom registry already moved to CLI Advanced workflows. The tutorials/mcp-optimizer file becomes unreferenced in the sidebar (the UI section already has its own version; reframe to vMCP is a later phase). Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Create a top-level Reference category containing client compatibility (moved from its orphaned top-level position) and registry schema references (previously not in any sidebar). CLI command reference, CRD spec, API server reference, and Registry API reference remain inline within their product sections. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Replace the single UI-only quickstart CTA with three cards routing readers to the right quickstart based on their use case: Desktop app for individual developers, CLI for power users, Kubernetes for teams and enterprises. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Contributor
There was a problem hiding this comment.
Pull request overview
This PR implements Phase 1 of the documentation restructuring plan, reorganizing the sidebar navigation to create clearer user journeys and better progressive disclosure. The changes are purely structural—no files are moved or renamed, ensuring all existing URLs remain stable.
Changes:
- Removed "Guides:" prefix from all sidebar section labels for cleaner navigation
- Moved quickstart guides into their respective product sections as the first item to make each section self-contained
- Restructured the CLI section with a new "Advanced workflows" category and renamed "Custom permissions" to "Permissions and security"
- Created a new "Integrations" section (replacing "Tutorials") for cross-cutting integration guides with third-party tools
- Added a new "Reference" section consolidating cross-cutting reference material, while keeping product-specific references within their sections
- Added "Choose your path" decision cards to the homepage for better user onboarding
Reviewed changes
Copilot reviewed 8 out of 8 changed files in this pull request and generated no comments.
Show a summary per file
| File | Description |
|---|---|
| sidebars.ts | Complete sidebar restructuring: removed "Guides:" prefixes, moved quickstarts into product sections, created Advanced workflows and Integrations sections, reorganized K8s and Registry Server item order, added Reference section |
| docusaurus.config.ts | Updated footer navigation link from "Tutorials" to "Integrations" |
| docs/toolhive/index.mdx | Added "Choose your path" cards with flexbox layout for Desktop app, CLI, and Kubernetes entry points |
| docs/toolhive/tutorials/quickstart-*.mdx | Added sidebar_label: Quickstart to all quickstart files for consistent display when embedded in product sections |
| docs/toolhive/guides-registry/intro.mdx | Added sidebar_label: Introduction for clearer navigation label |
rdimitrov
approved these changes
Feb 13, 2026
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
2 participants
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.
Description
Phase 1 of the documentation restructuring plan: sidebar navigation and information architecture changes. This PR reorganizes the sidebar to create clearer user journeys, self-contained product sections, and better progressive disclosure. No files are moved or renamed — this is purely a navigation/structure change.
Changes:
Type of change
Submitter checklist
Content and formatting
Navigation
sidebars.ts) updated for added, deleted, reordered, or renamed filesvercel.jsonfor moved, renamed, or deleted pages (i.e., if the URL slug changed)