什么是发行说明以及谁阅读它们?应该/可以通过为当前版本分发错误修复程序来实现自动化,还是需要仔细编辑人工? 那么,任何与软件发行说明有关的最佳实践(推理背后)的链接?
答案 0 :(得分:16)
错误修正和添加的功能。用户将阅读它们以确定它们是否应该解决安装增量升级的麻烦,或者等到下一个版本,因为这个版本不会添加他们需要的任何功能或修复他们正在使用的功能中的任何错误。
我会说他们至少需要一个人来阅读它们并确保每个音符都有用。这取决于您的错误修复的评论有多好。
答案 1 :(得分:6)
这实际上取决于您的应用程序的构建对象以及您的组织目标。但是,我倾向于认为发行说明需要是特定版本中包含的重要关键添加,增强或修复的简明列表。
有时简单地转储错误跟踪系统信息就足够了,有时候,我发现它们需要进一步完善。
关键是通常发行说明被认为是“嘿看看我们做了什么”类型的变更列表。
答案 2 :(得分:6)
发行说明对您的测试组织也很重要(如果有的话),以便他们知道发布和需求测试中发生了哪些变化。
答案 3 :(得分:5)
我们的发行说明是人工创建的而不是机器创建的。封面主要有三个主题。
版本中包含的内容 (文件列表)
如何安装
自上一版本以来发生了什么变化 (特别是如果没有变化的话 手册但是)。
第1项和第2项在版本与版本之间没有太大差异,但需要对其进行审核。第3项工作最多。
答案 4 :(得分:5)
发行说明在生产环境中也非常重要。
他们帮助解答这个古老的问题:
目前投入生产的是什么?
或更精确的问题:此版本中是否已修复此错误?
答案 5 :(得分:4)
我习惯性地阅读发行说明。我倾向于想要一个完整的功能变化列表(或者尽可能合理),以便更好地利用我对新产品的使用。
我希望看到某些关键错误或关键安全问题何时得到解决。
答案 6 :(得分:1)
如果您的客户除了正常程序之外还必须采取特殊措施才能进行升级,那么发行说明和自述文件非常重要。警告客户/用户因安装较新的补丁而自动发生的任何数据库升级也很有用。我看到它的方式,应该为系统管理员观众编写发行说明和自述文件。所以包括他们想要了解的各种事物:重要变化的摘要,如何安装,已知的错误,软件可能做的任何事情都会让人脱发等等。
答案 7 :(得分:1)
发行说明取决于您的组织。
我可以为我的组织说话。我们使用PDF格式的发行说明,每次发布clickonce或后端版本。我们向办公室经理发送发行说明。这是业务高级管理员(不仅仅是IT)使用的文档。该文档是他们了解正在发生的事情的一种方式。改变了什么,现在正在生产中的新功能,修复了错误,以及他们可能想要向用户解释的其他内容。
这是一个介于3到4页之间的文档,用简短的文字描述了此版本中已完成的工作。
答案 8 :(得分:0)
这当然在很大程度上取决于应用程序/服务的类型/诸如此类
但我发现阅读我最喜欢的开发工具的发行说明等。
经常让我偶然发现好看,有趣甚至是杀手的特征,如果我至少没有撇去笔记那么我可能会错过.....好吧,也许不是杀手,但是你得到我的漂移; - )
作为大多数计算机用户(现在是什么样的表达......) 我从不打扰普通的文档,所以这给了我 除了点击,盘旋和常见问题之外,还有一些额外的东西...
答案 9 :(得分:0)
发行说明适用于测试人员和用户了解新增/更改的内容。此外,在为您正在为其构建的客户端为软件的新“版本”计费时,可以将发行说明用作支持文档。 v1.31似乎更容易联系和深入研究。
不是手动编译两个列表,如果你可以使用你的发行说明为你做这件事,那就太好了。