副项目负责人#

发布负责人#

发布负责人 (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 的推广、外联和用户支持,以及维护与社区交流的场所。