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...