Stop Using (only) GitHub Releases
a day ago
- 作者意外升级了Rust依赖项，但因项目缺少CHANGELOG.md文件而面临困难，仅依赖GitHub发布说明。
- GitHub发布存在缺陷：分页导致交叉引用困难，它们不属于仓库本身，且若GitHub衰落则可能丢失。
- 仓库中的CHANGELOG.md文件会随代码迁移，应作为发布说明的主要来源。
- 该原则不仅限于变更日志：提交信息应解释变更原因，文档应存储在markdown文件中，任何能以文件形式表达的项目相关数据都应作为文件保存在仓库中。