光有东西是不够的，还要考虑怎么包装。即使你有再好的想法，再优雅的代码，再实用的思维，如果你不能和别人有效沟通，这些都不会有成果。没有有效的沟通，好的想法就会变成孤儿。
把英语(或者你的母语)想象成另一种编程语言。用自然语言写散文就像写代码一样:尊重干原则，等等，自动化等等。
英语是另一种编程语言。
了解你的观众。
与所有形式的沟通一样，关键是收集反馈。不要只等问题出现；问自己的问题。注意肢体语言和面部表情。神经语言编程有一个前提:“交流的意义在于你得到的反馈。”在传播过程中，不断提高对受众的理解。
知道自己想说什么。
在更正式的商务交流中，最难的部分可能是弄清楚你到底想说什么。小说家通常从一开始就用很多细节来总结他们的书，但技术作家经常坐在键盘前键入以下内容:
1.引言。
2.想到的事情。
计划好你想说的话，列个提纲，问问自己，“我用正确的方式向我的听众传达了我想说的话吗？”尽量压缩的简洁一点。
这种方法不限于写文档。当你要参加一个重要的会议或给一个重要的客户打电话时，写下你的想法，准备各种策略让你的观点被理解。
现在你知道了观众想要什么，是时候计划如何传达了。
选择合适的时机。
现在是周五下午6点，审计已经一周了。你老板的小儿子住院了，外面下着倾盆大雨，让你的回家之旅成了一场噩梦。这可能不是问她要不要升级你笔记本内存的最佳时机。了解你的受众的一个方面是找出他们的优先事项。当经理刚刚因为丢了一些源代码被老板骂了一顿的时候，更有可能抓住机会和他们讨论代码库的想法。你说的话不仅要和听众相关，还要及时。有时，只需要一个简单的问题:“现在是讨论的时候了 # 8230；#8230;时机好吗？”
选择一种风格。
根据你的听众调整你的表达。有些人想要一个正式的“公正的事实”简报。其他人更喜欢在进入正题前闲聊。他们在这方面的技能和经验是什么？他们是专家还是初学者？他们需要指导还是只是“太久了；“版本没看吗？如果有疑问，尽管问。
但是，请记住沟通是双向的。如果有人要你用几句话解释某件事，而你发现无法用几句话概括，那就告诉他们。这样的反馈也是一种沟通方式。
让它看起来不错。
想法很重要，但观众也想要一个好的演示。
太多的开发人员(包括他们的经理)在写文件的时候只关注内容。我们不同意。任何一个厨师(或者一个烹饪节目的主持人)都会告诉你，哪怕是一个不起眼的外表也会毁了你花在烹饪上的几个小时的辛苦。
包括观众在内。
通常，我们发现制作文档的过程比最终的草稿更重要。只要有可能，就让读者参与文档的初稿。倾听他们的反馈，学习他们的智慧。这有助于建立良好的工作关系，并通过这一过程产生更好的文件。
做一个倾听者。
如果你想让别人听你说话，那么你必须掌握的一项技能就是倾听。即使你掌握了所有的信息，即使你在一次正式会议上站在20个穿着得体的人面前 # 8211；如果你不听他们的，他们也不会听你的。
通过提问鼓励人们交谈，并试图让他们总结你的观点。把会议变成对话，更好地传达你的想法。谁知道呢，你甚至可能会学到一些东西。
回应他人。
当你问一个人问题时，如果他们不回答，你会认为他们很粗鲁。因此，当有人通过电子邮件向你询问信息或给你发备忘录时，你有多少次没有回应？忙碌的日子经常导致忘记事情。永远记得回复邮件，即使一句简单的“我稍后再联系你”就足够了。及时通知他人 # 8211；这样更容易让人原谅你偶尔的疏忽，让他们知道你没有忘记他们。
你说什么和你怎么说一样重要。
除非你完全与世隔绝，否则一定要学会沟通。你的沟通越有效，你的影响力就越大。
文件。
真正的程序员将文档视为整个开发过程的一部分。为了使文档更容易，通过保持文档准备好直接在代码中编写，避免重复工作并节省时间。事实上，所有实用的编码原则也适用于文档。
嵌入文档，而不仅仅是附加文档。
使用源代码中的注释生成有吸引力的文档非常简单。建议为模块和导出的函数添加注释；这对其他使用它们的开发者很有帮助。
然而，给每个函数、数据结构、类型声明等添加注释是有问题的。这种机械的注释实际上可能会使代码更难维护:修改一些东西意味着更新两个地方。因此，非API注释应该仅限于讨论它们存在的原因以及它们的意图和目的。当代码已经显示了如何完成事情时，注释就变得多余了，这违反了DRY原则。
源代码中的注释是记录其他地方无法记录的项目细节的绝佳机会:工程权衡、决策原则、被拒绝的备选方案等。
总结一下。
知道自己想说什么。
了解你的观众。
选择合适的时机。
选择合适的风格。
使其具有视觉吸引力。
让观众参与进来。
做一个好的听众。
回应他人。
将代码与文档绑定。
在线交流。
关于书面交流的一切都适用于电子邮件、社交媒体帖子、博客等。特别是电子邮件已经成为公司内部的主要沟通方式；它用于合同讨论、结算，甚至作为法庭证据。然而，出于某种原因，人们在发送破旧纸张时犹豫不决，但他们并不介意向世界发送看似混乱、语无伦次的电子邮件。
我的建议很简单:
发送前校对。
仔细检查拼写，找出可能的自动更正错误。
对原文的一些引用。没有人喜欢收到一封回复邮件，里面有几百行自己的文字，然后只有一行写着“我同意”。
如果引用某人的邮件，请引用并内嵌引用(而不是放在附件中)。社交媒体平台上的参考也适用于此。
避免在网上侮辱他人；不要做一个喜欢被恶搞或者被攻击的网络士兵。如果不能当面说，就不要在网上说。
发送前请检查收件人列表。这是一个持续的警告 # 8211；如果你在部门的邮件里批评上司，请注意不要把上司加到转发名单里。当然，最好的方法是根本不要在邮件中批评你的老板。
一旦发出，电子邮件和社交媒体帖子是不可逆的；许多大公司和政客都陷入了这个陷阱。因此，电子邮件被视为任何书面备忘录或报告。
