英語

• 簡體中文

文件子系統維護者入口配置檔案

文件“子系統”是核心文件和相關基礎設施的中心協調點。它涵蓋了 Documentation/ 下的層次結構（除了 Documentation/devicetree），scripts/ 下的各種實用程式，以及至少在某些時候的 LICENSES/。

值得注意的是，此子系統的邊界比正常的要模糊得多。許多其他子系統維護者喜歡控制 Documentation/ 的一部分，並且當方便時，更多人會自由地應用更改。除此之外，核心的大部分文件都以 kerneldoc 註釋的形式存在於原始碼中；這些通常（但不總是）由相關的子系統維護者維護。

文件的郵件列表是 linux-doc@vger.kernel.org。補丁應儘可能針對 docs-next 樹進行製作。

提交清單附錄

在進行文件更改時，您實際上應該構建文件並確保沒有引入新的錯誤或警告。生成 HTML 文件並檢視結果將有助於避免對事物如何呈現產生難看的誤解。

所有新文件（包括對現有文件的補充）都應該在變更日誌中的某個位置說明預期目標受眾是誰；這樣，我們確保文件最終出現在正確的位置。一些可能的類別是：核心開發人員（專家或初學者）、使用者空間程式設計師、終端使用者和/或系統管理員以及發行商。

關鍵週期日期

可以隨時傳送補丁，但在合併視窗期間，響應速度會比平時慢。由於文件補丁導致迴歸的風險較低，因此文件樹往往在合併視窗開啟之前關閉較晚。

審查節奏

我是文件子系統的唯一維護者，我正在利用自己的時間進行這項工作，因此對補丁的響應偶爾會很慢。我儘量在合併補丁（或當我決定不能合併補丁時）始終傳送通知。如果您在傳送補丁後一週內沒有收到回覆，請不要猶豫傳送 ping。