Skip to content

fix(develop-docs): Restore old header and fix sidebar collapse on sub-pages#16641

Merged
stephanie-anderson merged 8 commits intomasterfrom
fix/develop-docs-header-and-sidebar
Mar 2, 2026
Merged

fix(develop-docs): Restore old header and fix sidebar collapse on sub-pages#16641
stephanie-anderson merged 8 commits intomasterfrom
fix/develop-docs-header-and-sidebar

Conversation

@stephanie-anderson
Copy link
Contributor

@stephanie-anderson stephanie-anderson commented Mar 2, 2026

The nav refresh (fb3c1e1) added the new top navigation header unconditionally
to all doc pages, including developer docs which should use the simpler original
header. This also broke the sidebar on developer docs sub-pages because the
collapsible section isActive check used exact path equality instead of
prefix matching.

  • Add DevelopDocsHeader component with the original header layout
  • Conditionally render DevelopDocsHeader vs Header based on isDeveloperDocs
  • Fix DynamicNav isActive to use startsWith so child pages expand their parent section
  • Replace MobileMenu in develop docs header with an inline popover showing only external links (Changelog, Sandbox, Go to Sentry, Get Started), since MobileMenu hardcodes mainSections with user-facing doc routes that don't exist on developer docs
  • Fix hamburger breakpoint to md:hidden (768px) to match sidebar visibility threshold
  • Fix mobile menu breakpoint to lg-xl:hidden (1130px) to match desktop nav, closing the 768-1130px gap where neither menu was visible
  • Fix hamburger aria-label from hardcoded "Close" to "Toggle sidebar navigation" and remove aria-hidden

Co-Authored-By: Claude noreply@anthropic.com

…-pages

The nav refresh (fb3c1e1) added the new top navigation header unconditionally
to all doc pages, including developer docs which should use the simpler original
header. This also broke the sidebar on developer docs sub-pages because the
collapsible section `isActive` check used exact path equality instead of
prefix matching.

- Add DevelopDocsHeader component with the original header layout
- Conditionally render DevelopDocsHeader vs Header based on isDeveloperDocs
- Fix DynamicNav isActive to use startsWith so child pages expand their parent section

Co-Authored-By: Claude <noreply@anthropic.com>
@vercel
Copy link

vercel bot commented Mar 2, 2026

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

Project Deployment Actions Updated (UTC)
develop-docs Ready Ready Preview, Comment Mar 2, 2026 4:06pm
sentry-docs Ready Ready Preview, Comment Mar 2, 2026 4:06pm

Request Review

Copy link
Member

@chargome chargome left a comment

Choose a reason for hiding this comment

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

🚀

stephanie-anderson and others added 3 commits March 2, 2026 13:39
…xternal links

The MobileMenu component hardcodes mainSections from navigationData.ts which
contains user-facing doc links (/platforms/, /product/, etc.) that don't exist
on the developer docs site. Replace with an inline popover menu that only shows
the same external links as the desktop nav (Changelog, Sandbox, Go to Sentry,
Get Started).

Co-Authored-By: Claude <noreply@anthropic.com>
The sidebar is always visible at 768px+ (md) but the hamburger and mobile menu
used lg-xl:hidden (1130px), leaving them visible but non-functional between
768-1130px.

Co-Authored-By: Claude <noreply@anthropic.com>
Copy link

@cursor cursor bot left a comment

Choose a reason for hiding this comment

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

Cursor Bugbot has reviewed your changes and found 2 potential issues.

Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.

…sibility

- Change mobile menu from md:hidden to lg-xl:hidden so nav links are accessible
  between 768-1130px (where desktop nav is still hidden)
- Fix aria-label from hardcoded "Close" to "Toggle sidebar navigation"
- Remove aria-hidden="true" from label so button has an accessible name

Co-Authored-By: Claude <noreply@anthropic.com>
@stephanie-anderson stephanie-anderson enabled auto-merge (squash) March 2, 2026 15:55
@stephanie-anderson stephanie-anderson merged commit 4222905 into master Mar 2, 2026
19 checks passed
@stephanie-anderson stephanie-anderson deleted the fix/develop-docs-header-and-sidebar branch March 2, 2026 16:06
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.

2 participants