Skip to content

fix(docs): add sidebar ordering for Design Thinking documentation#832

Merged
WilliamBerryiii merged 2 commits intomainfrom
fix/design-thinking-sidebar-ordering
Mar 2, 2026
Merged

fix(docs): add sidebar ordering for Design Thinking documentation#832
WilliamBerryiii merged 2 commits intomainfrom
fix/design-thinking-sidebar-ordering

Conversation

@WilliamBerryiii
Copy link
Member

The Design Thinking documentation section lacked sidebar ordering metadata, causing pages to render in alphabetical order rather than a logical learning sequence. This PR added sidebar_position frontmatter to all 16 Design Thinking pages, created a category.json for the section, and adjusted downstream category positions to maintain a coherent sidebar hierarchy.

Design Thinking was placed at position 5 in the sidebar, after Getting Started, HVE Guide, and RPI. This positions it after the foundational "what is this?" and "core daily workflow" sections, recognizing that DT is a methodology users explore once they understand the platform basics.

Changes

  • Created category.json for the Design Thinking section at sidebar position 5, with collapsible navigation and a generated index page
  • Added sidebar_position frontmatter to all 16 Design Thinking markdown files, ordered as a learning progression: overview (README.md), methodology (why-design-thinking.md), tools (dt-coach.md, dt-learning-tutor.md), methods 1-9 in sequence, then integration guides
  • Bumped sidebar positions for 5 downstream categories (Agents, Architecture, Contributing, Security, Templates) by +1 to accommodate the new Design Thinking entry
  • Updated the category hierarchy list in .github/instructions/docusaurus-edits.instructions.md to reflect the revised ordering

Related Issues

Closes #830

- create _category_.json for Design Thinking at sidebar position 5

- add sidebar_position frontmatter to all 16 Design Thinking pages

- bump downstream category positions (Agents, Architecture, Contributing, Security, Templates)

- update docusaurus-edits instructions with revised category hierarchy

Closes #830

📚 - Generated by Copilot
@WilliamBerryiii WilliamBerryiii requested a review from a team as a code owner March 1, 2026 04:15
@github-actions
Copy link
Contributor

github-actions bot commented Mar 1, 2026

Dependency Review

✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.

Scanned Files

None

@WilliamBerryiii WilliamBerryiii added this to the v3.1.0 milestone Mar 1, 2026
@WilliamBerryiii WilliamBerryiii modified the milestones: v3.1.0, v3.2.0 Mar 1, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Design Thinking docs missing sidebar ordering after Docusaurus migration

2 participants