hiw3c AI 日报
Simon Willison 网页快照

软件博客中的反模式

原文标题 · Anti-Patterns in Software Blogging

软件博客中的反模式来自Michael Lynch的一些优秀的写作建议。迈克尔警告不要“曲折的引言”、误判读者的现有知识、假设他们会阅读你之前的帖子以及过度的形式。他还警告不要过度依赖链接作为不解释术语的借口。这个很疼!我一直这样做,但我一直怀疑几乎没有人点击过它们。(In Lobste.rs的评论迈克尔澄清说:“我的经验法则是,即使读者没有点击任何链接,我的文章仍然应该对他们有意义”。的

来源:Simon Willison · simonwillison.net

正文为英文,可一键机器翻译(仅首次需要等待)

Simon Willison’s Weblog

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.

Recent articles

Claude Haiku 5.5 - 7th October 2026

We're going to need default hard budget caps on pretty much everything - 3rd October 2026

OpenAI DevDay 2026 live blog - 29th September 2026

This is a link post by Simon Willison, posted on 7th October 2026 .

Monthly briefing

Sponsor me for $10/month and get a curated email digest of the month's most important LLM developments.