译者序

本文翻译自 2022 年的一篇文章，Writing is Magic。

作者 Marc Brooker 是 AWS 的一名工程师，从事 database, serverless, EC2 和 EBS 相关的工作。

译者水平有限，如有错误之处，请参考原文。

以下是译文。

[TOC]

有时，当人们在工作中向我寻求建议时，我会给他们写很长的电子邮件来回答他们的问题。有时，这些电子邮件通常很有趣，而不限于工作，所以我在这里分享它们。几天前，有人问我关于如何更好地沟通他们的想法和意见，如何扩大他们的影响力，以及如何推动共识。这是我的回复。

1 提升影响力的方式

发挥影响力的方法有很多。你可以与人们建立 1 对 1 的连接、召开小组会议、进行演讲、发起代码评审，或在 Slack 中争论。所有这些在适当的时候都会变得有价值。但我最常选择一种工具是：长文写作。写作是我所知道的最接近魔法的事情。

几乎每次我需要做出困难、微妙或有争议的决定时，我都会写一份文档。有时是半页，有时是六页。有时会更长，尽管简洁很有价值。我看到这种方法的一些好处，所以我一次又一次地使用它。

2 长文写作的好处

2.1 让自己真正想清楚问题

一旦写下来，你就会意识到自己的想法有多草率。

我常常发现，当我坐下来写某件事时，我对某件事的理解远不如我在淋浴时思考得那么好。事实上，当我尝试把事情写下来时，我对事情的看法会发生很大的改变。

写作真是一个强大的工具，可以让你理清思路。一旦你的头脑变得清晰，你就更容易向别人解释它。

2.2 让读者更加专注

让人们全神贯注地关注你的观点是非常困难的。如果你的团队有强大的文档文化，那么阅读是实现这一目标的唯一方法。

你给人们几页纸去读，最好是纸质的，他们可能会安静下来，专注于理解你的想法，至少几分钟。你可以不间断地阐述观点，讲故事，展示一些数据，或者询问他们的观点，只是你的声音。

很少有其他方法可以做到这一点。

2.3 穿越时间和空间

有时文档只能保存一个小时左右。它们的作用是推动决策，一旦决策做出后，它们就失效了。

在我的经验里，更多时候，有些文档远超最初的阅读。有人问我有关我十多年前写的文档的问题，他们今天仍然觉得这些文档有用。我出生前就喜欢阅读 CS 论文。写作的时间尺度比说话要好得多。我还鼓励人们共享文档。他们可以从最初的受众，到整个团队，到其他利益相关者，再到解决类似问题的人们。

书写在空间中的尺度比几乎任何其他交流方式都要好得多。有时，你的写作可能会超过你的预期，无论时间还是空间。你确实需要注意这一点。

2.4 总结抽象形成法则

出于某些原因，比起我说的东西，人们往往更相信我写的东西。也许我花时间写的事实表明它值得他们花时间阅。

我发现很多次我一遍又一遍说过的事情，一旦我写下来，它就成了法则。如果你注意到这种效果，要特别小心。

因为它会抑制讨论和沟通。它可能导致人们认为你的话比实际情况更加确定，将你的想法变成教条。有时它根本不起作用，你写下的一些东西也没有效果，但我不经常看到这种情况。

2.5 记录，便于回顾

我不知道我的记忆力是否特别糟糕，但我确实很容易忘记事情。我清楚地记得30年前我小学时的小卖部菜单。我并不总是记得我上周推动的决定的理由。

写作是我自己的记录。我自己的方式就是回去看看我当时在想什么，是否仍然如此。有时我发现两周前的我比现在聪明得多。有时恰恰相反。不管怎样，我认为记录很有价值。

最后一点是关于阅读文化。坐下来读，真正为了理解而阅读，是一项习得的技能。我建议每个人都在自己的组织中实践和示范这一点。

我喜欢阻止人们在文档评论中争论。我特别不鼓励人们挑剔。当然，如果你想提高写作水平，寻求「对文档的反馈」而不是「对文档中想法的反馈」是有用的。

但对于读者来说，挑剔语法比参考想法要容易得多，所以我喜欢限制这种反馈，或者将其带到不同的渠道。

既然这样，那就多写点吧。