软件架构师速成指南

第 20 章 为忙碌的人写作

本作品已使用人工智能进行翻译。欢迎您提供反馈和意见：[e-mail]

不要期望每个人都能逐字阅读

如果没时间阅读，请看图片

大多数 组织都充斥着枯燥乏味的文件，而这些文件基本上都没有被阅读过。但这并不意味着文件是个坏主意。做得好的话，它仍然是让广大受众达成共识的最佳工具。随着时间的推移，简短而准确的技术立场和决策文件已经成为我的架构团队的标志。

虽然本章的标题是对《大忙人日语》等流行书名的双关语，但它有意暗示了一种模糊性，即我们既在为忙碌的读者写作，同时也是忙碌的作者。

书写量表

遗憾的是，写作 比阅读要花费更多的精力，但吝啬写作是一分钱一分货的做法，因为书面文字比口语或幻灯片演示具有巨大的优势：

它的规模

你可以在不把所有人聚集在一个房间里的情况下，向众多听众发表演说（当然，播客也可以做到这一点）。

速度很快

人们的阅读速度比听力快两到三倍。

可搜索

您可以快速找到想要阅读的内容。

可对其进行编辑和版本控制

每个人都能看到相同的版本化内容。

因此，当你有足够多（或重要）的读者时，写作就会带来回报。不过，最大的好处是理查德-金顿（Richard Guindon）的见解："写作是大自然告诉我们思维有多邋遢的方式。仅凭这一点，写作就值得一练，因为它要求你理清思路，从而将其整理成一个有一定连贯性的故事情节。与大多数幻灯片不同，写得好的文件也是自成一体的，因此可以广泛传播，而无需进一步的评论。

质量与影响

写作的弊端在于，虽然你可以在一定程度上强迫别人听你说话（至少是假装听你说话），但要强迫别人读你的文章却要困难得多。我提醒写作者，"读者绝不需要翻页。他们会根据目前所读到的内容做出决定"。

假设主题有趣且与读者相关，我曾多次观察到写作质量与论文关注度之间的非线性关系，这也是衡量技术论文影响力的一个很好的替代指标。如果论文的质量达不到最低标准--例如，因为冗长、结构不良、错字连篇，或者使用了可笑的、难以阅读的字体--人们就根本不会阅读它，从而导致影响力为零。我把这种情况称为 "垃圾桶 "区，这是以读者可能产生的反应命名的。在另一端，当文档接近 "镀金 "区时，质量改进带来的额外影响最终会逐渐减弱。

因此，你需要将写作质量提升到 "甜蜜点"，然后专注于内容，而不是进一步打磨。虽然 "甜蜜点 "取决于主题和受众，但我认为 "垃圾桶 "区域比大多数开发者认为的更广，因此也更危险。关键影响者--你最重要的读者--都是非常忙碌的人，他们往往对超过几页的内容避而远之，也许除非是来自高薪咨询公司，在这种情况下，他们会让别人阅读，因为他们为此花了很多钱。

备注

曾经有一位高级主管拒绝阅读一份文件，因为封面上他的名字拼错了。我认为他是对的。

对于没有耐心的读者来说，措辞清晰和简明扼要并不是什么好东西：缺乏这两点，你的文章很快就会被扔进垃圾桶。明目张胆的错别字或语法问题就像汤里的苍蝇：味道可以说是一样的，但顾客不可能再来喝。

"在手"--第一印象最重要

鲍比-伍尔夫（Bobby Woolf）和我在撰写《企业集成模式》（Enterprise Integration Patterns）一书时，出版商强调了 "到手 "时刻的重要性，即潜在买家从书架上拿起书，快速浏览封面和封底，也许还有目录，并翻阅的时刻。读者是在这一瞬间做出购买决定的，而不是当他们偶然看到你在第 ...