Story: v2 documentation architecture
Table of Contents
This page documents a story in Sprint 17. It captures the goal, current status, acceptance criteria, and the tasks that compose it.
Goal
Port the entire sprint history (sprints 01-16) to the v2 cybernetic information architecture; enable and configure GitHub Pages; add dark CSS theme, sidebar TOC, and preamble; fix site build issues; close the v0 sprint history.
Status
| Field | Value |
|---|---|
| State | DONE |
| Parent sprint | Sprint 17 |
| Now | Completed 2026-05-20. |
| Waiting on | None. |
| Next | None. |
| Last touched | 2026-05-20 |
Acceptance
- All tasks complete; PR-by-PR breakdown in
git log.
Tasks
| Task | State | Start | End | Description |
|---|---|---|---|---|
| Task: [agile] Open Sprint 17 | DONE | 2026-05-22 | 2026-05-22 | - Opens Sprint 17 for development. |
| Task: [doc] Fix broken org-mode links in identifier-length-cleanup plan | DONE | 2026-05-22 | 2026-05-22 | Three [[*Special Cases]] links in doc/plans/2026-05-13-identifier-length-cleanup.org failed to resolve during org-export. |
| Task: [doc] v2 cybernetic information architecture (sprints 01-07) | DONE | 2026-05-22 | 2026-05-22 | Stands up the v2 information architecture under doc/v2/ and migrates the first |
| Task: [doc] v2 information architecture (sprints 08-11) | DONE | 2026-05-22 | 2026-05-22 | Migrates sprints 08-11 of v0 into the v2 cybernetic information architecture |
| Task: [doc] Add :eval never to list-presets sh block to fix site build | DONE | 2026-05-22 | 2026-05-22 | - Adds `:eval never` to the `#+begin_src sh` block in `how_do_i_list_available_presets.org` |
| Task: [doc] v2 information architecture (sprints 12-16); close v0 | DONE | 2026-05-22 | 2026-05-22 | Completes the v0 → v2 information architecture migration begun in PR #771 + #775. Five sprints (12-16) bring the final 8 |
| Task: [doc] Site theme: dark CSS + sidebar TOC + preamble + Pages enablement | DONE | 2026-05-22 | 2026-05-22 | Adopts the dark CSS + sidebar-TOC approach from |
| Task: [doc] Drop site banner, restore index cards, GitHub icon in nav | DONE | 2026-05-22 | 2026-05-22 | - Drop the oversized banner image from the site preamble — leaves the nav band alone at the top of every page. |
Decisions
- All at once
- the full sprint history was ported in one sprint rather than incrementally, to avoid a prolonged mixed-format state.
Out of scope
- v2 porting of v0 before sprint 01 (there is no earlier sprint history).