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