贡献#

PyMC 是一个开源的集体努力项目。有许多方式可以帮助它变得更好。而且所有这些方式都是受欢迎的！

以个人身份贡献#

PyMC 是许多人的共同努力，每个人都在他们喜欢并有一定专长的领域做出贡献，协调合作以尝试覆盖所有任务。

编码和文档是最常见的贡献类型，但还有许多其他事情你可以做来帮助PyMC，这些同样重要。此外，代码和文档都需要通过GitHub向pymc-devs组织下的某些仓库提交PR，虽然我们有一个拉取请求步骤详解指南可用，但GitHub可能不是每个人的菜。如果是你的情况，别担心，如果你想帮忙，你将非常受欢迎。

小技巧

如果你想为项目做出贡献，但不清楚可以在哪里贡献或如何开始，请在 Discourse 上联系我们。

我们还定期举办办公时间以提供更多支持，特别是对贡献者。如果你有兴趣参加，请在Discourse上订阅office-hours标签。

以下是一些非代码或文档贡献的示例，这些示例可以作为灵感。如果你有其他想法，请在 Discourse 上告诉我们，看看我们是否也能实现它。

  • 通过 在 Github 上提交问题 报告错误或提出改进建议

  • 在 Discourse 上回答问题

  • 通过撰写博客或发表演讲来教授PyMC并推广最佳实践

  • 帮助规划 PyMCon

  • 帮助进行外联和市场营销。这可能包括例如接触潜在的赞助公司，向可能在工作或研究中使用PyMC的人推广，以及确保使用PyMC的学者在其工作中正确引用它。

  • 帮助我们的募捐活动

  • 为 PyMCon 的视频 添加时间戳

通过 GitHub 上的 Pull Requests 贡献#

我们有一个 拉取请求步骤详解 和一个 拉取请求检查清单 页面，以帮助在贡献过程中的所有步骤，从你的第一次贡献到作为核心贡献者的常规贡献。

代码贡献礼仪#

  • 当你开始处理一个问题时，在你进行第一次提交后立即打开一个 Draft 拉取请求（参见 拉取请求步骤详解）。

  • 在提交包含新功能的PR之前，请通过在 issue 或 Discussion 中提出建议来联系维护者。根据建议的内容，我们可能会引导您到其他地方，例如 pymc-experimental 或 pymc-examples。

  • 任何没有开放拉取请求的问题都可以进行处理。

    • 如果一个拉取请求没有最近的活动，它可能会被关闭，或者被其他人接管。

    • “最近”的具体时间范围很难定义，因为它取决于贡献者、特定的代码更改以及其他上下文因素。作为一般规则，在没有其他阻碍的正常拉取请求中，通常每隔几天就会有活动。

    • 核心开发者将在选择关闭PR或将它们重新分配给他人时做出最佳判断。

  • 如果不确定是否有问题工单，请随时在工单中询问。但请注意，根据前一点，一个开放的拉取请求是认领问题工单的方式。请不要在工单中做出不切实际的承诺。

  • 如果你延迟或需要休息是可以的，但如果你无法将它推进到一个可以合并的状态，请在拉取请求中留下评论。根据变更的性质（紧急错误修复与新功能），核心开发者可以决定是否需要将PR重新分配以完成工作。

以机构身份贡献#

机构可以通过以下方式做出贡献：

如需更多信息，请联系 PyMC 团队，邮箱地址为 pymc.devs@gmail.com。