Michael Lynch 谈软件博客写作的反模式
Anti-Patterns in Software Blogging
Michael Lynch 撰文总结软件博客写作的常见反模式，包括冗长铺垫、误判读者已有知识、假设读者读过旧文、过度正式，以及过度依赖链接而不解释术语。他建议文章即使读者不点任何链接也应能读懂，并主张用自己说话的方式写作。他指出，随着越来越多开发者把写作交给 AI，软件博客正变得千篇一律，读者更渴望有个性的文字。
7th October 2026 - Link Blog
Anti-Patterns in Software Blogging (via) Some excellent writing advice from Michael Lynch. Michael warns against "meandering intros", misjudging your reader's existing knowledge, assuming they'll read your previous posts, and excessive formality.
He also warns against overreliance on links as an excuse not to explain terminology. This one hurt! I do this all the time, but I have a nagging suspicion that almost nobody ever clicks on them.
(In a Lobste.rs comment Michael clarifies that "My rule of thumb is that my article should still make sense to the reader even if they don't click any links". That works for me.)
This point about using your own voice is crucial:
Beginner software bloggers suffer from a mass delusion that you have to write in a stiff, overly formal way for people to take you seriously [...]
Just write the way you talk.
With so many developers delegating their writing to AI, software blogging is becoming bland and homogenous. Readers are hungry for writing with personality.
来源：Simon Willison · simonwillison.net