Skip to content

Plain-English docs

The same information as ../technical/, written for anyone who isn't reading code day to day — analogies instead of file:line citations, but nothing invented and nothing simplified into being wrong. Both tracks are required to stay in sync — see ../README.md for the index of both.

  • OVERVIEW.md — what the cockpit does, in five steps; the two halves that make it up; why the layout changes shape on different screens (and the real bug that taught us why); and the trust/safety promises this system makes on purpose.
  • getting-started.md — the two commands that turn it on.
  • learn-more.md — what the pieces are actually built with, explained without jargon, with links to read further.
  • making-of.md — the build story so far, growing over time, told without needing to read code.