Your documentation belongs with your code

Tue, 13 Oct 2026 11:02:59 -0400

If this dog-umentation is right, can you spot all the problems in the generated arf-ifact?

For years, I’ve advocated for keeping developer documentation in the same code repository as the code it describes. In the age of AI, that practice has become even more important.

Clear, Concise, Complete, and Correct: Avoiding AI Slop

Mon, 28 Sep 2026 16:58:36 -0400

We used to call Callie "C". There’s a particular kind of writing that has become increasingly easy to produce: technically plausible, grammatically correct, reasonably well organized, and almost completely exhausting to read.

You know the stuff–it has a lot of words. It has headings for everything. It explains things that don’t need explaining, repeats the same point three different ways, and somehow manages to leave out the details you actually needed.

AI on Andy M Mallon - AM²

Your documentation belongs with your code

Clear, Concise, Complete, and Correct: Avoiding AI Slop