Rust crates 的发行说明在哪里发布

【问题标题】：Where are release notes of Rust crates publishedRust crates 的发行说明在哪里发布
【发布时间】：2021-09-18 19:27:05
【问题描述】：

是否有一个标准地方可以让人们看到某个 crate 版本中的新内容/修复内容？我在crates.io 或docs.rs 中找不到这样的部分。

【问题讨论】：

【解决方案1】：

Rust 生态系统中没有固定的东西。

有一些模糊的标准会被越来越多的 crate 维护者遵循，主要是 keepachangelog 之一，但 crates.io 或 docs.rs 中没有具体的显示，所以你必须去存储库。

IMO 最好在这些参考站点中自动添加指向名为 CHANGELOG.md 或 release.md 的文件的链接。

【讨论】：

【解决方案2】：

不，发行说明没有标准位置。您可能会在 crate 存储库中获得幸运，或者（非常罕见）在 docs.rs 上的特殊模块中（例如，like this）。

【讨论】：

【解决方案3】：

没有这样的功能。

最标准的做法可能是在 Git 存储库的根目录下有一个 CHANGELOG.md 文件。 Git 存储库链接可使用repository key 获得。 crates.io 和 docs.rs 都显示这些链接。

例如，rand crate 就是这样做的，他们的 CHANGELOG 可以在 https://github.com/rust-random/rand/blob/master/CHANGELOG.md 获得

【讨论】：