Story: Improve site documentation discoverability
Table of Contents
This page documents a story in Sprint 21. It captures the goal, current status, acceptance criteria, and the tasks that compose it.
Goal
A visitor to the published website can reach any key catalogue page (skills, recipes, memories, knowledge) from the site menu, and every relevant glossary entry links directly to its catalogue. Currently the skills catalogue is unreachable from the menus and the Skills glossary entry carries no link to it; the same gap exists for other catalogue types. The fix is two-pronged: expose catalogue pages in the site navigation, and add cross-links from glossary entries so a reader who lands on a definition can immediately jump to the live catalogue.
Status
| Field | Value |
|---|---|
| State | BACKLOG |
| Parent sprint | Sprint 21 |
| Now | Not yet started. |
| Waiting on | Nothing. |
| Next | Pick first task to start. |
| Last touched | 2026-06-25 |
Acceptance
- Skills catalogue is reachable from the site menu (no URL knowledge required).
- The Skills glossary entry links to the skills catalogue page.
- Recipes, memories, and knowledge catalogue pages are similarly reachable from the site menu.
- Glossary entries for recipe, memory, and knowledge cross-link to their respective catalogue pages.
- No catalogue page is orphaned (reachable only by direct URL).
Tasks
| Task | State | Start | End | Description |
|---|---|---|---|---|
| Link skills glossary entry to skills catalogue and add catalogue to site menu | BACKLOG | Add an org-roam link from the Skills glossary entry to the skills catalogue page, and expose the skills catalogue in the published site navigation menu. | ||
| Link recipes glossary entry to recipes catalogue and add catalogue to site menu | BACKLOG | Add an org-roam link from the Recipes glossary entry to the recipes catalogue page, and expose the recipes catalogue in the published site navigation menu. | ||
| Link memories glossary entry to memories catalogue and add catalogue to site menu | BACKLOG | Add an org-roam link from the Memory glossary entry to the memories catalogue page, and expose the memories catalogue in the published site navigation menu. | ||
| Link knowledge glossary entry to knowledge catalogue and add catalogue to site menu | BACKLOG | Add an org-roam link from the Knowledge glossary entry to the knowledge catalogue page, and expose the knowledge catalogue in the published site navigation menu. |
Decisions
Out of scope
- Redesigning the site menu structure beyond adding catalogue entries.
- Creating new catalogue pages — only wiring existing ones into navigation and glossary.
- Glossary entries for concepts that have no corresponding catalogue.