Add Downloads and Agile nav entries to the site
Table of Contents
This page documents a story in Sprint 18. It captures the goal, current status, acceptance criteria, and the tasks that compose it.
Found misfiled in product_backlog/inbox/ during deep backlog refinement
(2026-07-11) — the story itself is DONE (task DONE 2026-05-25) and was
never actually deferred; the stray "Deferred…" note was wrong. Restored
to its real sprint folder; sprint 18's table row updated to DONE.
Goal
The site header gains two new nav entries:
- Downloads — links to a new
doc/downloads.orgpage that lists every release with download links per OS (Linux, macOS, Windows), sourced from GitHub releases. - Agile — links to the existing
doc/agile/agile.orgindex so visitors can browse the project's agile artefacts directly from the nav.
Status
| Field | Value |
|---|---|
| State | DONE |
| Parent sprint | Sprint 18 |
| Now | Complete. Pending PR merge. |
| Waiting on | Nothing. |
| Next | — |
| Last touched | 2026-05-25 |
Acceptance
doc/downloads.orgexists with a version table (columns: Version, Name, Linux, macOS, Windows) covering every GitHub release that has binary assets.- The nav in
.build-site.elincludesDownloadspointing to/OreStudio/doc/downloads.htmlandAgilepointing to/OreStudio/doc/agile/agile.html, in the positions defined by the task. - The published site renders both links correctly.
Tasks
| Task | State | Start | End | Description |
|---|---|---|---|---|
| Task: Create downloads.org and wire Downloads + Agile into site nav | DONE | 2026-05-25 | 2026-05-25 | Write doc/downloads.org with the full release/binary table; add Downloads and Agile href entries to site-html-preamble in .build-site.el. |
Decisions
Out of scope
- Automating the downloads table from the GitHub API at build time; the table is hand-maintained for now.
- Adding a Windows binary to v0.0.17 (that is a separate CI/release concern).