There are 2-3 upcoming additions to the top-level nav of the Codex docs site:
- For T333437, we're adding a new top-level nav item to the Codex docs site for the Style Guide.
- We also want to start documenting composables (T295186) and the documentation for one is already being completed. We need to provide people a way to easily access the composables section.
- We might add a section for Patterns
Even just adding Style Guide is making the top-level nav pretty long. We should consider ways to consolidate some of the top-level menu items.
Option 1: Design + Dev - declined
Other design systems have a section for Design and a section for Development. That makes sense in some ways, but the design tokens, components, icons, and patterns all apply to both design and development. I'm not sure this is right for the Codex docs.
Option: 2 Add "Toolkit" - selected
Another option would be to group all of the usable packages/things under a single top-level nav item called "Toolkit" (or another word if there's a better suggestion). This would include:
- Design tokens
- Components
- Patterns
- Icons
- Composables
See a demo of this here or view a screenshot:
Acceptance criteria
- Determine the best architecture: we agree on Option 2
- Implement Option 2
- Style the new dropdown menu with Codex tokens