Writing as Thinking

Engineers tend to treat documentation as the residue of work — the bit you scrape off the side of the pot when the cooking is done.

But writing is not the residue. It is the cooking. The act of forming a sentence forces a decision your code was happy to leave fuzzy.

The README you draft before the first commit will save you three architectural revisits later. Try it once and you will not go back.