5 参与贡献 on 编程那些事儿

5.1 文档

Sun, 23 Aug 2026 16:44:00 +0800

原文链接: https://rust-random.github.io/book/contrib-doc.html

所有文档均为英文，但不偏好任何特定方言。

文档应面向多种受众：既包括经验丰富的 Rustacean，也包括相对新手；既有统计建模或密码学经验的人，也包括对这些主题陌生的人。由于往往无法编写适合所有人的文档，我们倾向于简洁的技术文档，并引用面向更特定受众的扩展文章。

Sun, 23 Aug 2026 16:44:00 +0800

原文链接: https://rust-random.github.io/book/contrib-scope.html

随着时间的推移，项目范围不断扩大，Rand 从使用单体 crate 转变为使用「主」crate 加上多个单一用途 crate。对于新功能，必须考虑它是否适合 Rand 项目，以及适合放在何处。

Sun, 23 Aug 2026 16:44:00 +0800

原文链接: https://rust-random.github.io/book/contrib-test.html

Rand 有许多单元测试，尽管这些测试并不全面或完美（欢迎改进）。我们倾向于为所有新功能编写测试。

第一行测试只需从相应目录运行 cargo test。由于 Rand 支持 no_std（仅 core）、core+alloc 和 std 环境，测试所有三种环境很重要（取决于所讨论代码适用的特性）：

Sun, 23 Aug 2026 16:44:00 +0800

原文链接: https://rust-random.github.io/book/contrib-bench.html

我们已有许多基准测试：

1
2
3
4


cargo +nightly bench

# 在少数情况下，nightly 特性可能使用不同的代码路径：
cargo +nightly bench --features=nightly

分布的基准测试现在位于 rand_distr crate 中；所有其他基准测试（包括我们所有的 RNG）位于主 rand crate 中（因此有许多 dev-dependencies）。