Rust 核心開發團隊成員 Steve Klabnik 在博客宣佈 Rust 文檔團隊已解散。
Steve 介紹到，早在2016年8月，他們成立了一個團隊來負責 Rust 的文檔工作。當時主要負責以下工作內容：
- 標準庫文檔
- 相關書籍和其他長篇文獻
- Cargo 文檔
- 錯誤索引
此外，Rust 文檔團隊還會以不同的方式為 Rust 生態相關的文檔編寫提供幫助。首先是以顧問的身份幫助促成希望提供更好的文檔的目標；其次是檢查整個生態的文檔，找到自己能輸出貢獻並可以為所有 Rust 開發者產生巨大影響的地方。說白了，Rust 文檔團隊不僅僅是負責整個生態的文檔，還要努力在更多的方面做出貢獻，而不僅僅是 Rust 項目本身。
即便如此，此時所做的這些工作對 Rust 的發展都十分有必要，不過因為使用 Rust 的人不多，所以文檔也沒有太多。但問題在於，一個團隊的人給其他眾多團隊的人寫文檔，長期來看無疑是行不通的，雖然在短期內這是一個絕對必要的好策略。
最原始的文檔發展到現在已經演進成以下狀態：
- 標準庫文檔已基本完成，當有新的 API 加入時，libs 團隊會為它們編寫最初版本的文檔
- 書籍由 Steve 和 Carol 維護
- Cargo 文檔由 Cargo 團隊負責
- 錯誤索引用於記錄編譯器錯誤，因此這是編譯器團隊的工作
除此之外，Rust 文檔團隊還添加了以下內容：
- Rust 使用示例
- rustc圖書和rustc指南
- 參考手冊
- The Rustonomicon
列表的內容還在繼續擴充，但一直以來 Rust 文檔團隊的成員並沒有真正發展起來，Steve 也表示嘗試過幾次讓大家參與進來，但大多數人都不喜歡寫文檔。所以這個階段真正寫文檔的人只有 Steve 自己。不過 Steve 的時間有限，所以從2018年8月份開始，Rust 文檔團隊就再沒有開過一次會議，最近也沒有認真討論過文檔 RFC。
因此，Steve 覺得這篇文章並不是宣佈 Rust 文檔團隊的結束，而是現在的情況就是如此。Steve 表示自己仍會繼續文檔方面的工作，以及維護他負責的書籍，還計劃向 Rust 項目提交一些文檔相關的 PR。
分享到:
閱讀更多 Java架構師日記 的文章
