Michael Lynch lists anti-patterns in software blogging, from meandering intros to overly formal prose

Michael Lynch warns software bloggers against meandering intros, misjudging reader knowledge, assuming readers have read earlier posts, excessive formality, and overreliance on links instead of explaining terminology.

He advises that an article should still make sense even if readers click no links. Simon Willison endorses the advice and argues that writing in one's own voice matters as more developers delegate writing to AI.