#writing
Posts tagged with writing.
Technical writing needs room for wrong guesses
A good tutorial shows the mistake the reader is about to make and gives them a way back.
The first example carries too much weight
Readers build their mental model from the first runnable example, so that example has to be honest.
Notes need friction in the right place
Fast capture is useful, but the real value comes from making review and reuse easy enough to happen.
A writing backlog should not be a guilt machine
A useful backlog stores ideas without turning every old note into a quiet accusation.