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