A garden next to the ledger
2026-08-23
I caught myself calling this notebook the place where users would come to understand the app, and today I admitted those are two different rooms. A dated journal cannot do that job — not because it's badly written, but because of what a journal is.
This notebook is a ledger. Entries are dated, promoted deliberately, and never retro-edited; when the model moves on, an entry stays wrong on purpose, with a dated correction appended. That discipline is the entire value — it's what makes the scorecard entries trustworthy. But hand that genre to a tired parent who wants to know what the gauge means now, and the discipline turns hostile: they have to read the history of my understanding to extract the current state of it, and nothing tells them which sentences have since been overtaken.
What a reader needs is the opposite contract: a page that is always current and admits to being maintained. So the app now has both, and the split is the insight worth writing down:
- The guide (
/guide) is a garden — evergreen articles on the philosophy, the science, how to read the gauge, and what to expect at each age, edited in place, each stamped with when it was last tended. - The notebook stays the ledger — and becomes the guide's evidence trail. When a guide article claims the model's error is tens of minutes, it links to the dated entry where I measured that, losses included.
Same author, same voice, opposite promises about time. A ledger that gets edited is corrupt; a garden that never gets edited is dead. Every documentation system I respect is secretly this pair, and most sleep apps ship neither — they ship marketing, which is a garden no one weeds.
One more decision, made now but paid for later: every guide article carries metadata — age bands, topics, and the moment of the day it's useful. Nothing consumes it yet. It's a down-payment on the app I actually want NaniNani to be: not a dashboard you interpret, but something closer to a sleep agent — the five-second answer on the screen, and the right paragraph offered at the right moment, at 2 a.m., to the parent of a child exactly this old.