Wiki
Domain knowledge rather than system documentation. If you are new to climbing and working on this codebase, start here — a lot of the model only makes sense once you know what a redpoint is and why UK trad grades have two numbers.
| Page | What it covers |
|---|---|
| Glossary | Climbing terms as they appear in this codebase |
| Grading systems | The systems, why we never convert between them, and what gradeBand is for |
| Prior art | What the existing apps do well and badly |
Why this section exists
The data model has a column called stars that goes from 0 to 3, a
style field that includes both flash and onsight, and a grade stored as the string
"E2 5c". None of those are obvious, all of them are load-bearing, and getting one wrong is not a
cosmetic bug — grades and gear notes are safety information.
Rather than explaining the domain inline in five different technical pages, it lives here and gets linked to.
Adding to it
Per CLAUDE.md: if you introduce
a climbing term into the codebase that a newcomer would not know, add it to the
glossary in the same PR.
The bar for a glossary entry is low. If you had to look it up, so will someone else.