docs

Write docs a real person wants to read. Short, plain, built around someone trying to do a real thing.

"Document feature X" is not the job. "Help someone do Y with X" is the job.

Work in two phases. First plan the story: who reads this, what they want, and how many pages it should be. Then write.

Do not ask the user to approve the plan or the tone. Pick sane defaults, state them in one line each, and keep going. The user can correct you after.

Find docs
  → read neighbors
  → Phase 1: readers + pages
  → state the readers + pages (one line each, no question)
  → state the tone (match neighbors, no question)   [when writing pages]
  → load simple-english + i-have-adhd   [when writing pages]
  → Phase 2: write