Curate sidebar with explicit ordering and grouping #68

New issue

Open

opened 2026-03-14 23:57:26 +00:00 by freemo · 0 comments

freemo commented

2026-03-14 23:57:26 +00:00

Owner

Metadata

Commit Message: docs: curate sidebar with explicit ordering and logical categories
Branch: feature/m3-v11-docs-sidebar

Background

sidebars.js uses autogenerated mode with no ordering control, mixing polished docs with bloated ones.

Expected Behavior

Explicit sidebar categories: Getting Started -> Player Guide -> Server Administration -> Developer Guide, with controlled ordering.

Acceptance Criteria

sidebars.js uses explicit item/category definitions
Logical ordering: Overview -> Player -> Server -> Developer
All docs included in appropriate categories

Subtasks

Rewrite sidebars.js with explicit structure
Verify build with bundle exec rake documentation

Definition of Done

This issue is complete when all subtasks are done, commit created on the specified branch, PR submitted and merged.

## Metadata - **Commit Message**: `docs: curate sidebar with explicit ordering and logical categories` - **Branch**: `feature/m3-v11-docs-sidebar` ## Background `sidebars.js` uses `autogenerated` mode with no ordering control, mixing polished docs with bloated ones. ## Expected Behavior Explicit sidebar categories: Getting Started -> Player Guide -> Server Administration -> Developer Guide, with controlled ordering. ## Acceptance Criteria - [ ] `sidebars.js` uses explicit item/category definitions - [ ] Logical ordering: Overview -> Player -> Server -> Developer - [ ] All docs included in appropriate categories ## Subtasks - [ ] Rewrite `sidebars.js` with explicit structure - [ ] Verify build with `bundle exec rake documentation` ## Definition of Done This issue is complete when all subtasks are done, commit created on the specified branch, PR submitted and merged.