Michael Lynch warns that software bloggers frequently commit specific errors by writing meandering introductions, assuming readers know previous posts, and using excessive formality. He also criticises the overreliance on external links as a substitute for explaining technical terms. Simon Willison notes that these habits are becoming more common because many developers now delegate their writing tasks to artificial intelligence.
The issue is that AI-generated content often produces bland and homogenous text, stripping away the personality that readers currently crave. Willison argues that beginners mistakenly believe stiff writing commands respect, whereas authenticity is far more effective. The advice suggests writers should simply adopt their natural speaking voice rather than adopting a corporate tone. This approach directly counters the uniformity introduced by automated tools.
- Stop assuming readers have read your earlier articles
- Explain terminology instead of linking to it
- Write exactly how you speak in conversation
