如何让发布说明发挥作用

恭喜！您已准备好发布您的软件包的最新版本。现在您需要确保您的发布说明井然有序。当然，您可以只在包装盒上写上“缺陷修复和性能改进”，然后就此作罢，但这并没有真正告诉您的用户任何信息。

发布说明既用于支持也用于营销。它们告诉您当前的用户为什么这个新版本对他们很重要，并向潜在用户展示您的软件。因此，您需要使内容清晰、易懂，最重要的是，相关。编写发布说明没有唯一的方法，所以这是一般建议，而不是法令。

一种流行的趋势是将发布说明变成包含很多玩笑的叙述。如果那是您喜欢的风格，那就去做吧——但请记住，笑话通常是与上下文相关的，而且您认为好笑的东西可能对您的读者来说完全摸不着头脑。而且，当然，您不能忘记包含重要的信息。

入门

也许本文最重要的要点是为将要阅读发布说明的人员编写发布说明。对于面向用户的软件，请关注面向用户的行为，而不是内部实现。例如，说“单击‘取消’按钮会让你的电脑着火”，而不是“thermalEventTrigger 在 cancelThatThing 函数中默认为 True”。

尽量将每个条目限制在一到两句话。重点是突出重点部分，而不是给出详细的解释。如果您有公共问题跟踪器，请包含一个链接（或至少一个问题编号），读者可以在其中找到详细信息（如果他们有兴趣）。

您不必以这种方式布局您的发布说明，但我喜欢以下格式。从版本号和发布日期开始。对于主要版本，您还可以包含几句话来突出主要主题。例如，“此版本侧重于添加电子邮件客户端，因为那是所有软件的最终状态。”

如果新版本引入了兼容性或默认行为的更改，请明确突出显示这些更改。您的用户会感谢您，提供用户支持的任何人也会感谢您。描述将遇到行为更改的情况、如何处理更改，以及如果用户不对更改采取行动会发生什么情况。对于次要版本，您可能没有任何不兼容的更改，因此您可以忽略此部分。

现在是时候吹嘘您的软件所做的所有酷炫的新功能了，但请记住要关注用户的角度。例如，“该软件现在支持自动检测午餐照片并将其发布到 Instagram。”

没有软件是完美的，本节是您告诉读者您的团队为使项目变得更好而付出的所有努力。用过去时态写这些说明，因为不良行为已经消失了。如果清楚地知道缺陷是在哪里引入的，请包含该信息。一些项目也在此部分中包含文档中的缺陷。

因为没有软件是完美的，所以总会有一些缺陷尚未修复。本节是列出这些问题的地方。您不必坦白一切；重点关注影响功能的缺陷，尤其是自上次发布以来发现的缺陷。用将来时态写这些，当您解决它时，您只需更改动词时态，它就可以移到上一节。