编写发行说明的良好做法

在交付每个版本的软件时，我们都必须编写发行说明。例如，以下是我写发行说明时添加的一些术语：

够了，还是还有别的吗？

release

— 酷编程器
source

这看起来像一个重复programmers.stackexchange.com/questions/66377/...

别忘了添加了功能

— 棘手怪胎

Answers:

我认为追随者将为良好做法铺平道路

//日期相关

//功能相关

//错误相关

//依赖关系

//测试相关

//与版本控制相关

在某些时候，值得强调的是最终用户可能希望更改其配置或工作流程的内容。

大多数最终用户并不关心测试结果。他们希望它具有高质量，无论发行说明说什么。

关于发行说明，最重要的是要知道，每增加一句话，就会失去另外10％的读者。因此，您必须严格优先考虑当前用户需要了解的版本。

— 曼德勒（Mh Mahbubur Rahman）
source

它也有一些次值得强调的东西最终用户可能希望在他们的配置或工作流程改变

— JK。

@jk。是的，你是对的。我已经将我的回答作为您的好评进行了编辑。

— Md Mahbubur Rahman

大多数最终用户并不关心测试结果。他们希望它具有高质量，无论发行说明说什么。

— 亨里克（Henrik）2012年

@Henrik发行说明可能比终端用户虽然别人有用

— JK。

关于发行说明，最重要的是要知道，每增加一句话，就会失去另外10％的读者。因此，您必须严格优先考虑当前用户需要了解的版本。

— ddyer
source

每行可能会损失10％的随便的，不感兴趣的（或懒惰的）读者。这些读者不是您的发行说明所针对的读者。那些在乎您所做工作的人将阅读所有内容，并感谢每一条相关的内容-您只需要小心包含确实需要放入文档中的绒毛即可。

— gbjbaanb 2012年