Latest Results
docs: collapse sidebar nav and group Guide sections (#7131)
# Me:
I found the current front page a bit overwhelming because the sidebar is
fully expanded and there's a lot of stuff in there, requiring a decently
long scroll to hit the bottom. This also distracts me from reading the
content in the intro.
before:
<img width="1680" height="982" alt="Screenshot 2026-06-15 at 1 54 56 PM"
src="https://github.com/user-attachments/assets/a63e5f87-7d3f-40eb-8b71-5807aa59bfe6"
/>
after:
<img width="1675" height="988" alt="Screenshot 2026-06-15 at 1 54 43 PM"
src="https://github.com/user-attachments/assets/d783f6bd-d9de-4c3f-a8a8-3ef0c78cc0bf"
/>
As a drive by I also refactored the sections a bit, namely added
subsections to data connectors (there's a whole lot of them), and
appropriately modified the data connectors overview page too.
# Claude:
## Changes Made
The docs sidebar previously expanded every section at once (~40 links on
first load). This makes the Guide nav reveal depth gradually:
- Remove `navigation.expand` so sections render collapsed and
auto-expand only the branch matching the current page.
- Group scaling / optimization under a **Scaling & Performance**
section, and the trailing project links (Roadmap, Benchmarks, Community,
Release Notes, Usage Telemetry) under **Resources**.
- Sub-group the 26 **Data Connectors** pages by source type (Object
Storage, Table Formats, Catalogs, Databases, Files, Other Sources,
Custom) so an expanded section shows a handful of categories instead of
one long list.
- Keep **Architecture** and **Observability** as top-level entries.
The **Data Connectors overview page** is reorganized to mirror these
same categories and order, so the on-page structure matches the sidebar.
This also surfaces connectors that were missing from the overview
(Turbopuffer, Hugging Face Datasets, and the catalog integrations).
No pages or links were removed — this only regroups the existing nav and
content. Verified with a local `mkdocs build` (no new cross-reference
warnings).
## Related Issues
Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Latest Branches
0%
0%
0%
© 2026 CodSpeed Technology