infra: reorder sidebar — move Concepts below Guides, Languages and Developer Tools above References

[marc0olo]

Background

The current sidebar order is:

1. Getting Started
2. Guides
3. Concepts
4. Developer Tools
5. Languages
6. References

Concepts (Explanation in Diataxis terms) sits correctly after Guides, but Languages and Developer Tools are buried after Concepts when they are reference material developers consult while actively coding — they should be easy to reach without scrolling past 20+ concept pages.

Proposed order

1. Getting Started
2. Guides
3. Concepts
4. Languages
5. Developer Tools
6. References

Why this ordering:

• Getting Started → Guides: the core learning path; task-oriented content before anything else
• Concepts after Guides: explanation of why things work the way they do — complementary to guides, not a prerequisite for them
• Languages after Concepts: pure reference material (Motoko/Rust API docs) consulted while writing code; Concepts provides the mental models that make language reference comprehensible
• Developer Tools after Languages: a single overview page listing available tooling; consulted occasionally for discovery, not during active development
• References last: specs and standards — the deepest reference material, least frequently visited

Why NOT to put Developer Tools before Guides: Getting Started already establishes the essential tooling. Developer Tools is a reference page — moving it before Guides would interrupt the learning flow by placing reference material before task-oriented content.

Changes required

One edit to sidebar.mjs — move the Languages and Developer Tools entries to after the Concepts block.

When to do this

Independent of the Learn Hub migration batches; can be done at any time.

Related

• docs: post-migration holistic review — content placement, nav structure, glossary, first-use terms #226 (post-migration holistic review — includes broader nav/structure work)

[marc0olo]

closed via #230