主要观点：

• 变更日志是与用户沟通的重要方式，但写好不易。
• 应写变更日志文件，而非仅在 GitHub 发布中包含信息。
• 变更日志需遵循基本格式和写作风格，如保持标题简单、注明日期、使用图标突出重点、聚焦影响、提供上下文、不包含所有内容等。

关键信息：

• 基本格式方面：标题只包含包版本字符串；注明发布日期（推荐 ISO 格式）；使用图标帮助读者识别不同部分。
• 写作风格方面：专注于变化本身，避免过多背景介绍；可提供上下文，如突出主要功能、迁移资源等；只包含影响用户使用的变更，如功能、破坏变更和 bug 修复。

重要细节：

• GitHub 发布的问题：难以跳转到特定版本的注释、本地安装无变更日志信息、依赖 GitHub 导致切换困难、日期与实际发布不同步、比较版本需多标签。
• 完整示例遵循所有指南，优化了可扫描性和简洁性，包含不同版本的变更内容及相关链接。
• 强调应写详细的 PR 描述。