feat(docs): update navigation components for improved accessibility and structure#3517
Open
feat(docs): update navigation components for improved accessibility and structure#3517
Conversation
✅ Deploy Preview for boosted ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
3 tasks
✅ Deploy Preview for boosted ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
There was a problem hiding this comment.
Pull request overview
Updates docs navigation and homepage layout to improve small-viewport behavior and accessibility, addressing mobile display issues from #3507.
Changes:
- Add a new
outgoingSVG symbol to the docs sprite(s) and use it for the mobile docs “Browse docs” toggle. - Adjust mobile “On this page” toggle styling by removing the custom
.bd-toc-toggleclass/styles. - Update homepage masthead CTA container to wrap/stack more appropriately on smaller screens.
Reviewed changes
Copilot reviewed 4 out of 7 changed files in this pull request and generated 2 comments.
Show a summary per file
| File | Description |
|---|---|
| site/static/sosh/docs/[version]/assets/img/ouds-web-sprite.svg | Adds outgoing symbol for the new docs navigation icon. |
| site/static/orange/docs/[version]/assets/img/ouds-web-sprite.svg | Adds outgoing symbol for the new docs navigation icon. |
| site/static/orange-compact/docs/[version]/assets/img/ouds-web-sprite.svg | Adds outgoing symbol for the new docs navigation icon. |
| site/src/scss/_toc.scss | Removes now-unused .bd-toc-toggle styling. |
| site/src/layouts/DocsLayout.astro | Removes .bd-toc-toggle class from the TOC collapse button. |
| site/src/components/home/MastHead.astro | Updates CTA layout to stack/wrap better on small viewports. |
| site/src/components/header/SubNav.astro | Reworks the mobile docs navigation toggle (icon + improved label structure). |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
…ay "browse docs" when TOC empty
louismaximepiton
approved these changes
Apr 30, 2026
| d="M1 8a.5.5 0 0 1 .5-.5h13a.5.5 0 0 1 0 1h-13A.5.5 0 0 1 1 8zM7.646.146a.5.5 0 0 1 .708 0l2 2a.5.5 0 0 1-.708.708L8.5 1.707V5.5a.5.5 0 0 1-1 0V1.707L6.354 2.854a.5.5 0 1 1-.708-.708l2-2zM8 10a.5.5 0 0 1 .5.5v3.793l1.146-1.147a.5.5 0 0 1 .708.708l-2 2a.5.5 0 0 1-.708 0l-2-2a.5.5 0 0 1 .708-.708L7.5 14.293V10.5A.5.5 0 0 1 8 10z" | ||
| ></path> | ||
| </svg> | ||
| <nav class:list={['bd-subnavbar py-small d-lg-none', !sidebarMap[slug] && 'd-none']} aria-label="Secondary navigation"> |
Member
There was a problem hiding this comment.
Suggested change
| <nav class:list={['bd-subnavbar py-small d-lg-none', !sidebarMap[slug] && 'd-none']} aria-label="Secondary navigation"> | |
| <nav class:list={['bd-subnavbar py-small d-lg-none', { 'd-none': !sidebarMap[slug] }]} aria-label="Secondary navigation"> |
don't know what's best
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
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.
Related issues
Closes #3507
Description
Checklists
Progression (for Core Team only)
ouds/mainfollowing conventional commitLive previews