变更日志哲学
内容提要
文章讨论了变更日志和发布说明的重要性，强调变更日志应关注用户所需信息，而非内部变更。Sumana建议分别制作变更日志和用户导向的发布说明，以提供更全面的信息。作者倾向于结合两者，制作手写的变更日志，关注用户需求，同时考虑维护者的精力和用户的注意力。最终，每个项目应根据自身情况平衡工作量和收益。
关键要点
-
变更日志应关注用户所需的信息，而非内部变更。
-
建议分别制作变更日志和用户导向的发布说明，以提供更全面的信息。
-
发布说明可以包含项目级的信息，如新讨论论坛的启动或维护者关注的变化。
-
将变更日志和发布说明分开可能会增加维护者的工作量，而用户的注意力有限。
-
每个项目应根据自身情况平衡工作量和收益，考虑其受众和资源。
-
在变更日志中，描述修复的错误和重要的行为变化，并链接到新文档和贡献者。
延伸解读
用户需求与变更日志的关系
变更日志的设计应以用户需求为核心，避免过多内部信息的干扰。用户通常只关心与他们使用体验直接相关的变化，因此在撰写变更日志时，维护者应考虑如何清晰地传达这些信息，以提升用户的理解和满意度。
维护者的工作量与信息传达
将变更日志与发布说明分开可能会增加维护者的工作量，尤其是在小型项目中。维护者需要权衡信息的全面性与自身的精力，选择最适合的方式来传达信息，以避免过度负担和信息过载。
受众分析的重要性
在撰写变更日志时，了解目标受众的特征至关重要。大多数用户可能只会关注少量信息，因此维护者可以选择针对大多数用户的需求进行信息传达，而不是试图满足所有潜在贡献者的期望。
延伸问答
变更日志和发布说明有什么区别？
变更日志关注每个非琐碎的变更，而发布说明则更侧重于用户所需的信息和项目级的变化。
为什么变更日志应关注用户所需的信息？
因为用户需要了解对他们有影响的变化，而不是内部的技术细节，这样才能更好地使用产品。
如何平衡变更日志和发布说明的制作工作量？
每个项目应根据自身情况评估受众和资源，找到适合的工作量与收益的平衡点。
发布说明可以包含哪些类型的信息？
发布说明可以包含项目级的信息，如新讨论论坛的启动、维护者关注的变化等。
在变更日志中应该包含哪些信息？
变更日志应描述修复的错误、重要的行为变化，并链接到新文档和贡献者。
如何提高用户对变更日志的关注度？
可以通过手写变更日志，专注于用户需要的信息，并在结尾总结未提及的变化，提供链接到git历史。
