返回资讯中心
外部精选
软件工程
#开发者实时流

工程师建议:写博客先告诉读者是否该继续读

来源标题:Assume People Are Not Interested in Your Blog Post

Daniel Sada 提出,写技术文章应开篇就说明内容面向谁,让读者决定是否继续读,而不是浪费读者时间。他举例说,Snowflake 内部邮件常用「如果你不开发这块代码,可以停止阅读」这类开场。他认为写 2000 字却包含大量与多数读者无关的内容很不可取。

Hacker News 最新dshacker2026/11/22 · 今天3 分钟阅读

这个来源的 RSS 只提供摘要,下面是原文导语;完整论述请点「打开原文」。

为读者而写:开篇就告诉他们这篇文章写给谁看,让他们自己决定要不要继续读下去。

如果你不是为他人而写,那现在就别读这篇了。

我在 Snowflake 的时候,大家都会做一件特别酷的事,就是一种礼仪性的做法。每封邮件的第一句话都是:“如果你不开发代码中这个特定部分,你可以不用往下读了。”或者“如果你不属于财务团队,你可以不用往下读了。”

这让我深入思考了“为他人而写”到底意味着什么。你需要服务于你的读者。同样,考虑自己占用了多少空间也非常重要。在 Slack/Teams 的讨论串里,你会先用 3 到 5 行介绍你的话题,然后大家可以在讨论串里找到更多细节。

当我看到有人写了两千字,内容却可能并不适用于所有人时,我真的会感到难过。尤其是当他们写得不够简洁的时候。那是在浪费读者的眼睛。

作者:Daniel Sada。欢迎通过 hello [at] danielsada.tech 打招呼。

本条为导读摘要,完整论述请以原文为准。

打开原文
去社区讨论 →