Anti-Patterns in Software Blogging

In the realm of software blogging, certain pitfalls have emerged that hinder effective communication. Michael Lynch, a seasoned writer, offers valuable guidance on what to avoid. He cautions against long, convoluted introductions that fail to capture the reader's interest. Another common mistake is underestimating the reader's prior knowledge and presuming they will recall details from earlier posts. A formal tone is also discouraged, as it can alienate the audience.

Furthermore, Lynch warns against an excessive reliance on hyperlinks as a crutch, implying that explaining technical terms is unnecessary. This approach may be convenient for the writer, but it can frustrate readers who are unwilling or unable to follow every link. A Lobste.rs commenter clarifies Lynch's stance, stating that the article should remain intelligible even if readers skip the links. This principle ensures that the content remains accessible to a broader audience.

A crucial aspect highlighted by Lynch is the importance of using one's unique voice. Many novice bloggers fall into the trap of believing they must adopt a stiff, overly formal writing style to establish credibility. However, he emphasizes that writing in a conversational manner is far more engaging for readers. With an increasing trend of developers delegating their writing tasks to AI, software blogging risks becoming monotonous and lacking individuality. Readers yearn for content that reflects the writer's personality and perspective.

Simon Willison, a software developer, exemplifies this perspective through a link post dated October 7, 2026. In his post, he solicits support through a $10/month subscription, promising readers a monthly digest of significant developments in large language models (LLMs). By adhering to Lynch's advice, Willison aims to produce writing that stands out in a crowded field, attracting readers seeking fresh perspectives and engaging content.