Skip to content

v6 Docs reorg#42413

Open
mdo wants to merge 2 commits into
v6-devfrom
v6-docs-reorg
Open

v6 Docs reorg#42413
mdo wants to merge 2 commits into
v6-devfrom
v6-docs-reorg

Conversation

@mdo
Copy link
Copy Markdown
Member

@mdo mdo commented May 15, 2026

Reorganizes into subpages. Not fully fleshed out yet. Pushing this up because of some feedback from @coliff. Curious to hear thoughts on direction; there's plenty more to polish and fix up.

mdo and others added 2 commits May 14, 2026 21:45
- Create DocsSubNavbar.astro: renders section tabs from sidebar data using nav-overflow
- Create _subnavbar.scss: sticky section nav styles
- Update BaseLayout.astro: render DocsSubNavbar in sticky header for docs layout
- Update docs.scss: import subnavbar styles

Co-authored-by: Cursor <cursoragent@cursor.com>
@mdo mdo requested a review from a team as a code owner May 15, 2026 05:34
@mdo mdo added this to v6.0.0 May 15, 2026
@github-project-automation github-project-automation Bot moved this to Inbox in v6.0.0 May 15, 2026
@coliff
Copy link
Copy Markdown
Contributor

coliff commented May 15, 2026

deploy preview not building :-( but I was able to build locally. I think I like it! it's an improvement for sure. Still quite a few things to work out, like how it works on smaller screens.

image

I wonder if for this main nav docs if it could use the new nav overflow component so on MD screens for example you can still have 1-click access to Getting Started, Guides, Base, Forms, Components, Helpers instead of them all being behind a dropdown.

I think I'd still prefer Components listed together alphabetically - it's simply faster to find the component you want, but maybe that's just me so curious to hear @julien-deramond and others thoughts on it.

@mdo
Copy link
Copy Markdown
Member Author

mdo commented May 15, 2026

Yup, the nav overflow is the idea there—I had to pull these changes out of a few different commits and stashed changes that I nearly lost, and some is still not there. Needs a big review and polish pass, but didn't want to lose anymore before I could do that :).

Note on alphabetical components. I like the grouping because it helps associate things for dependencies and related pieces of the design system, but don't want that to be at the expense of common sense or first instinct :). Will try it out when I get back to this!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

Status: Inbox

Development

Successfully merging this pull request may close these issues.

2 participants