发行说明和变更日志有什么区别？

Question

软件包通常随附变更日志和/或发行说明。它们之间有什么区别？它们是否都应包含在新版本的发布中？

Answer 1

要直接回答您的问题，您可以在软件版本中同时包含这两个问题。

Release notes是交付给客户的一组文档，旨在提供产品或服务新版本发布的详细说明。这些工件通常由营销团队或产品所有者创建，并包含功能摘要，错误修复，用例和其他支持材料。发行说明可用作用户文档以外内容的快速指南。

相反，changelogs是按逆序排列的新功能，增强功能，错误和其他更改的完整列表。变更日志通常链接到变更管理系统中的特定问题或功能请求，并且还可能包含指向提供变更的开发人员的链接。

Answer 2

是的，我认为您可以在新版本中都包含这两者。

对我而言，主要区别在于，您可以在发行说明中以更全面的语言解释新内容或已更改的内容。

对于变更日志，您必须添加有关变更的更多技术细节，例如，带有指向差异的链接的提交消息或带有指向技术讨论的链接的PR。