Skip to content

feat(docs): update navigation components for improved accessibility and structure#3517

Open
hannahiss wants to merge 5 commits intoouds/mainfrom
ouds/main-mobile-overflow
Open

feat(docs): update navigation components for improved accessibility and structure#3517
hannahiss wants to merge 5 commits intoouds/mainfrom
ouds/main-mobile-overflow

Conversation

@hannahiss
Copy link
Copy Markdown
Member

@hannahiss hannahiss commented Apr 16, 2026

Related issues

Closes #3507

Description

  • Homepage: make buttons in sub-header wrap when screen is too small
  • Improve "On this page" display
  • Improve "Browse docs" toggle button for better navigation. => I proposed a new icon but this can be discussed

Checklists

Progression (for Core Team only)

Live previews

@netlify
Copy link
Copy Markdown

netlify Bot commented Apr 16, 2026

Deploy Preview for boosted ready!

Name Link
🔨 Latest commit 1234bb5
🔍 Latest deploy log https://app.netlify.com/projects/boosted/deploys/69e1012d13574900084370e3
😎 Deploy Preview https://deploy-preview-3517--boosted.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@hannahiss hannahiss linked an issue Apr 16, 2026 that may be closed by this pull request
3 tasks
@hannahiss hannahiss marked this pull request as ready for review April 16, 2026 15:40
@boosted-bot boosted-bot moved this from In Progress / Draft to Need Dev Review in 🟣 [Orange-Boosted-Bootstrap] PRs Board Apr 16, 2026
@netlify
Copy link
Copy Markdown

netlify Bot commented Apr 16, 2026

Deploy Preview for boosted ready!

Name Link
🔨 Latest commit 8af8c86
🔍 Latest deploy log https://app.netlify.com/projects/boosted/deploys/69f0dbcab3c66000079f080a
😎 Deploy Preview https://deploy-preview-3517--boosted.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

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

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 outgoing SVG 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-toggle class/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.

Comment thread site/src/components/header/SubNav.astro
Comment thread site/src/components/header/SubNav.astro Outdated
Comment thread site/src/components/header/SubNav.astro Outdated
Comment thread site/src/components/header/SubNav.astro
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">
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

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

@boosted-bot boosted-bot moved this from Need Dev Review to Need Lead Dev Review in 🟣 [Orange-Boosted-Bootstrap] PRs Board Apr 30, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Need Lead Dev Review

Development

Successfully merging this pull request may close these issues.

[OUDS] Mobile display issues

5 participants