Rust 核心开发组成员 Steve 宣布：Rust 文档团队暂停

Rust 核心开发组成员 Steve Klabnik 在官方博客宣布Rust 文档团队暂停。

Steve Klabnik 提到早在 2016 年 8 月组成了一个团队来负责 Rust 文档的相关工做。这个团队主要负责的内容以下：

• 标准库文档
• 相关图书和其余长篇文档
• Cargo 文档
• 错误索引

此外，文档编制团队会以几种方式提供有关生态系统文档编制的帮助。首先，以咨询的身份：帮助但愿为本身提供更好文档的人们了解如何实现该目标。此外，监视整个生态系统文档，并肯定可为全部 Rustaceans 作出贡献并产生巨大影响的地方。若是 Rust 项目自己具备出色的文档，可是生态系统具备糟糕的文档，那么人们仍然会对 Rust 的文档情况感到沮丧。须要明确的是，这并不意味着拥有生态系统文档，而是要致力于以更多方式作出贡献，而不单单是 Rust 项目自己。

当时，全部这些都是很是须要的。使用 Rust 的人还很少，而且没有那么多的文档。

可是文档是一件有趣的事。这确实是一个跨领域的问题。从长远来看，一个团队为其余大量团队编写文档并无真正的用处。短时间而言，这是绝对必要且良好的策略。

让咱们再次看一下那些原始资源的现状：

• 标准库的文档已基本填写完毕，当添加新的 API 时，libs 团队将编写一些初始文档。
• 相关图书由史蒂夫和卡罗尔（Steve and Carol）维护。
• Cargo 的文档是 Cargo 团队的职责。
• 错误索引描述了编译器错误，所以这是编译器团队的工做。

Rust 文档团队还添加了如下内容：

• Rust 使用示例
• rustc图书和rustc指南
• 参考手册
• The Rustonomicon

Steve Klabnik 在文章中提到：『一直以来，团队成员并无真正扩大。我尝试了几回让人们参与其中，可是大多数人只是不喜欢写文档。在这一点上，惟一真正写文档的人是我，最近我也没有不少时间。所以，自 2018 年 8 月以来，咱们尚未召开过文档团队会议。这些天也没有真正的讨论过 RFC 文档。所以，此博客文章并无真正宣布文档团队的结束，而只是描述了今天已经存在的事实。我将继续在核心和本书上进行工做。我计划未来再提交一些文档 PR。我要感谢过去在团队中的每一个人，以及多年来提交文档 PR 的每一个人。不少人真的很喜欢Rust的文档，没有大家全部人就不可能实现。』

https://blog.rust-lang.org/in...