專案副領導#
發布管理員#
發布管理員 (RM) 的任命是針對 Matplotlib 的次要版本 (A.B.x) 發布系列,而不是固定的任期。他們負責該系列所有次要版本的完整發布生命週期,包括:
確保最新消息、API 變更和發布說明是最新的
發布的時機
應該或不應該從主分支回溯哪些變更
重建並發布網站
將 sdist 和 wheels 發布到 pypi
通知下游封裝者有關發布的消息
宣布發布 (與社群經理協調)
一個人可以同時擔任多個發布系列的 RM。
API 領導#
良好的 API 對於可用性和使用者滿意度至關重要。我們努力實現直觀、易於使用、一致且穩定的 API。API 領導 (AL) 負責 API 的整體演進。他們特別確保:
新增的功能是合理的,也就是說,它們不會重複現有功能,也不會超出函式庫的預期範圍
新增的功能與現有的 API 一致
新增的功能的設計不會造成任何未來的責任,也就是說,它們不會無意中限制未來的擴展或暴露內部結構
變更會仔細權衡未來使用者利益及其對現有程式碼的影響
變更會遵循棄用政策,因此不會讓使用者措手不及
首席工程師#
Matplotlib 依賴廣泛且深入的程式碼庫來實作其公共 API;底層細節必須正確才能忠實地實作該 API。與負責函式庫功能的 API 領導不同,首席工程師負責如何實作。他們是以下方面的聯絡人:
渲染
檔案格式
文字/字體處理
與 GUI 工具組的整合
內部資料結構和 API
參考文件領導#
Matplotlib API 參考文件分為 docstring 和 rst 來源。此文件需要完整且準確,因為我們的使用者將其視為給定方法將執行之動作的最終權威 (除了閱讀來源程式碼之外)。
參考文件領導 (RDL) 負責確保 docstring:
格式正確並按預期渲染
技術上正確
完整
除了 docstring 之外,RDL 還負責 sphinx 建置機制和我們的 sphinx 擴充功能。
敘述性文件領導#
除了參考文件之外,Matplotlib 還有敘述性文件。此文件可以是簡短的「食譜」範例、較長的教學課程和說明函式庫內部結構如何以及原因的散文。這包括位於主要儲存庫和 Matplotlib 組織中其他儲存庫的內容。
敘述性文件領導負責管理所有這些內容,包括範圍、組織、級別、語氣和聲音。
秘書#
負責確保每週會議有議程,並遵循議程。
負責維護每週筆記。
社群經理#
Matplotlib 的真正力量以及它作為一個專案如此長壽的原因是程式碼周圍的人員社群。這個社群需要維護。社群經理 (CM) 是一個涵蓋多項非常不同任務的職位,這個角色未來可能會拆分,並可能需要招募更多助理。CM 負責 Matplotlib 的宣傳、外展和使用者支援,以及維護與社群對話的場所。