Tag: Documentation
Documentation-Driven Development: The First Secret to AI Software Engineering

Documentation is not an afterthought once the code is finished. It is an input before coding begins, working memory during development, and the acceptance standard at delivery. A few days ago, I wrote AGI Machine Guns Are Now Standard Issue, about …
Documentation is not an afterthought once the code is finished. It is an input before coding begins, working memory during development, and the acceptance standard at delivery. A few days ago, I wrote AGI Machine Guns Are Now Standard Issue, about …
OINK: After Six Years of Wrestling with Documentation Frameworks, Codex Finally Got Me Over the Line

Building a documentation site is not hard. The hard part is keeping it useful five years later. At first, you only want to put a few Markdown files online. Then the requirements start growing on their own: full-text search, dark mode, multiple …
Building a documentation site is not hard. The hard part is keeping it useful five years later. At first, you only want to put a few Markdown files online. Then the requirements start growing on their own: full-text search, dark mode, multiple …
I Asked AI to Prove That Eating Garlic Prevents Middle Ear Infections

Last month, my old friend Ma roasted me in our group chat for using ChatGPT every day to churn out grand-sounding, LinkedIn-style aphorisms with no basis in experience. He said, “You can make up any theory you want—say, that eating garlic reduces the …
Last month, my old friend Ma roasted me in our group chat for using ChatGPT every day to churn out grand-sounding, LinkedIn-style aphorisms with no basis in experience. He said, “You can make up any theory you want—say, that eating garlic reduces the …
Yes, I Use AI to Write

People often leave the same short comment under my posts: “AI wrote this.” Correct. I use AI, and I use it heavily. I do not think there is anything to hide there. But the topic itself is worth addressing seriously at least once: how should a person …
People often leave the same short comment under my posts: “AI wrote this.” Correct. I use AI, and I use it heavily. I do not think there is anything to hide there. But the topic itself is worth addressing seriously at least once: how should a person …