Skip to content

Conversation

@ntotten
Copy link
Member

@ntotten ntotten commented Feb 11, 2026

Summary

  • Replace the custom GuidesPage (full-page React component with filter checkboxes) with a standard category-based sidebar navigation
  • Organize 28 guides into 5 sidebar categories: Authentication & Security, OpenAPI & API Design, Routing & Backends, Performance & Data, and Testing & Development
  • Add a card-based landing page (docs/guides/overview.mdx) using GuidesPage as an MDX component, grouped by sidebar categories
  • Update scripts (generate-guides.ts, add-guide-frontmatter.ts) to handle the nested navigation structure via extractDocsFromNavigation
  • Add sidebar filter to all navigation sections (API Management, AI Gateway, Developer Portal, Platform)
  • Filter out Zudoku docs with zuplo: false frontmatter

Test plan

  • Verify the Guides tab in the top nav links to the overview landing page
  • Verify the sidebar shows categorized guides with a filter input
  • Verify guide cards on the landing page link to the correct doc pages
  • Verify other sidebar sections (API Management, AI Gateway, etc.) still render correctly
  • Run npm run typecheck to confirm no type errors

🤖 Generated with Claude Code

Replace the custom GuidesPage with a standard category-based sidebar
while keeping a card-based landing page as an MDX doc. Guides are now
organized into five sidebar categories: Authentication & Security,
OpenAPI & API Design, Routing & Backends, Performance & Data, and
Testing & Development.

Co-Authored-By: Claude Opus 4.6 <[email protected]>
@vercel
Copy link

vercel bot commented Feb 11, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment Feb 11, 2026 10:15pm

Request Review

The sidebar now handles guide navigation directly, so the custom
GuidesPage React component is no longer needed.

Co-Authored-By: Claude Opus 4.6 <[email protected]>
Only process category items when extracting guide paths, skipping
top-level doc entries like the overview page that don't have tags.

Co-Authored-By: Claude Opus 4.6 <[email protected]>
ntotten and others added 2 commits February 11, 2026 17:10
The guides/overview page is a landing page, not a guide, so skip it
when checking that all docs/guides/ files are in the sidebar.

Co-Authored-By: Claude Opus 4.6 <[email protected]>
Add GuidesOverview component that renders guide cards grouped by
sidebar categories, and use it in the guides overview MDX page.

Co-Authored-By: Claude Opus 4.6 <[email protected]>
@ntotten ntotten enabled auto-merge (squash) February 11, 2026 22:13
@ntotten ntotten merged commit 8bae19b into main Feb 11, 2026
14 of 15 checks passed
@ntotten ntotten deleted the guides-sidebar-navigation branch February 11, 2026 22:18
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