软件博客写作中的反模式( via )Michael Lynch 提供了一些极佳的写作建议。Michael 警告不要写“漫无边际的开场白”、不要误判读者已有的知识水平、不要假设他们会读过你之前的文章,也不要过度正式。
他还警告不要过度依赖链接,以此作为不解释术语的借口。这一点戳到我了!我一直这么做,但我隐隐怀疑几乎没有人会去点那些链接。
(在 Lobste.rs 的一条评论中,Michael 澄清道:“我的经验法则是,即使读者不点击任何链接,我的文章也应该仍然对他们有意义。”这对我来说很受用。)
关于使用自己的声音这一点至关重要:
初学软件博客写作的人普遍存在一种错觉,认为你必须用生硬、过度正式的方式写作,别人才会认真对待你 [...] 就按你说话的方式去写。随着如此多的开发者将写作委托给 AI,软件博客正变得平淡而千篇一律。读者渴望有个人风格的文字。
转载声明:本文为转载整理,原文版权归原作者及原站点所有。
原文来源:Simon Willison
原创地址:https://simonwillison.net/2026/Oct/7/anti-patterns-in-software-blogging/
原文作者:Simon Willison;如有侵权,请联系管理员删除。