Fix top navbar and left sidebar navigation, adding pathways#18026
Fix top navbar and left sidebar navigation, adding pathways#18026AlannaBurke wants to merge 2 commits intopytorch:mainfrom
Conversation
🔗 Helpful Links🧪 See artifacts and rendered test results at hud.pytorch.org/pr/pytorch/executorch/18026
Note: Links to docs will display an error until the docs builds have been completed. ❌ 3 New FailuresAs of commit ca2ec4b with merge base 7824373 ( NEW FAILURES - The following jobs have failed:
This comment was automatically generated by Dr. CI and updates every 15 minutes. |
This PR needs a
|
|
Thanks for this change, I am testing the newly added the page : https://doc-previews.s3.us-east-1.amazonaws.com/pytorch/executorch/18026/user-pathways.html Hope this will be useful to our user base , specillay the new beginners who look to onboard. |
@psiddh the new use-case specific pathway pages look great! Since the Beginner, Quick Start, and Advanced pathways are separate URLs, it will be tracked explicitly on the dashboard. Will add another widget to track page views and active users for Pathways |
Summary
Fixes the top navigation bar and left sidebar across the ExecuTorch docs site.
Builds on the decision matrix / user pathways work from the previous commit.
Changes
Top Navbar (
conf.py)enable_navbar_dropdowns: Falseso everytop-level nav item is a flat, direct link with no hover dropdown
header_links_before_dropdownto
10so all 9 nav items are always visiblenavigation_depth: 2,show_nav_level: 1,collapse_navigation: Falsefor consistent left sidebar depth
Top-Level Nav Structure (
index.md)api-sectionintoadvanced-topics-sectiongrids into one clean 3-column grid
API Reference (
advanced-topics-section.md)sidebar under Advanced
Pathway Pages Sidebar (
user-pathways.md,pathway-*.md)user-pathways.mdtoctree caption from "User Pathways" to"Find Your Path" to match the navbar label
pathway-beginner.md,pathway-quickstart.md, andpathway-advanced.mdthat caused aRecursionErrorduring the Sphinx buildBefore / After
Preview