Story: Documentation improvements
Table of Contents
This page documents a story in Sprint 25. It captures the goal, current status, acceptance criteria, and the tasks that compose it.
1. Goal
An umbrella story for incremental improvements to ORE Studio's documentation and public-facing site (the org-mode-exported website under `index.org`/`readme.org`/`assets/`). Tasks are added as ideas come up rather than scoping the whole story up front.
2. Status
| Field | Value |
|---|---|
| State | DONE |
| Parent sprint | Sprint 25 |
| Now | Nothing. |
| Waiting on | Nothing. |
| Next | Nothing. |
| Last touched | 2026-09-23 |
3. Acceptance
4. Tasks
| Task | State | Start | End | Description |
|---|---|---|---|---|
| Scaffold story: Documentation improvements | DONE | 2026-08-04 | 2026-08-04 | Story scaffolding rides this task: documents, sprint wiring, and the scaffold PR. Close it before merging that PR. |
| Add an image carousel to the website homepage | DONE | 2026-08-04 | Initial task for: Documentation improvements | |
| Add systemd unit for site start/stop | DONE | 2026-08-04 | 2026-08-04 | Manage the local site-preview server (compass site serve) as a systemd unit, with proper start/stop commands, instead of ad hoc background processes. |
| Recapture dedicated carousel screenshots | ABANDONED | 2026-09-23 | The carousel's first pass reuses old release screenshots (v0.0.24, v0.0.12, v0.0.15, v0.0.20) as stand-ins for org chart, reference data, compute, and shell – none purpose-built for the carousel. Capture fresh, dedicated composite screenshots (several windows open, current UI/theme) for each carousel topic. | |
| Consolidate site top navigation | ABANDONED | 2026-09-23 | The site-wide nav (Project/Modeling/Developer/Resources dropdowns) fragments the user journey per external review. Group developer technical specs and model definitions under a unified Docs dropdown. Site-wide change (every page, not just the homepage) via ores-build-site.el's site-html-preamble – deserves its own scoped task/PR, not bolted onto the carousel work. | |
| Add a quickstart CLI snippet to the homepage | ABANDONED | 2026-09-23 | A short terminal install/quickstart command block on the homepage for fast developer onboarding, per external review. Scope: what the snippet actually shows (git clone + build? a hosted install script?) needs deciding before implementation. | |
| Add compass-code-review-comments skill | DONE | 2026-08-11 | 2026-08-11 | New Claude Code skill that reviews and cleans code comments, wired into CLAUDE.md so it applies to all code we create or edit. |
| Document Skew Stickiness Ratio knowledge page | DONE | 2026-08-25 | Add a knowledge page on how implied volatility surfaces move when spot moves: sticky strike vs sticky delta, the Skew Stickiness Ratio (SSR) that measures ATM-vol response against the ATM skew, and its effect on delta and gamma. | |
| Expand the Random Walk knowledge page | DONE | 2026-09-10 | Fold the stationarity, unit-root and first-passage material into the Random Walk knowledge page, with the source attributed. | |
| Write knowledge pages on structures and deal composition | DONE | 2026-09-11 | 2026-09-11 | Add knowledge pages under doc/knowledge/ covering trade structures and how ORE composes a deal from its parts. |
5. Decisions
6. Out of scope
7. Result
Closed at sprint 25 close. This story was open-ended; the done tasks are what shipped.