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

Question

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

Answer 1

要直接回答您的问题，您可以将两者都包含在您的软件版本中。

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

相反，更改日志是按时间倒序排列的新功能、增强功能、错误和其他更改的综合列表。变更日志通常链接到变更管理系统中的特定问题或功能请求，也可能包括提供变更的开发人员的链接。

Answer 2

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

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

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