Writing Documentation Nobody Has to Decode
Most documentation is accurate and useless. The difference is almost always structure, not effort.
Ari Bennett · 8 min read
Writing
The archive
Every post, filed by subject. Filter by category, search the full text, or read straight through from the newest.
11 posts
Notes on Leaving a Comfortable Job
No burnout story and nothing to expose. Just the reasoning behind trading something good for something described, and what it actually cost.
Ari Bennett · 6 min read
Reading Code Faster: Five Habits That Compound
Most of the job is reading, not writing. Getting faster at it did more for my output than any other skill I have deliberately practised.
Ari Bennett · 7 min read
The Ten Minute Retro
The hour long monthly retrospective produced three action items and two regrets. The version I kept is ten minutes, weekly, alone with a text file.
Ari Bennett · 5 min read
Writing a Newsletter People Actually Open
Four years of sending a short newsletter every second Wednesday, and the six rules that survived.
Ari Bennett · 7 min read