贡献#

PyMC 是一个开源的集体项目。有很多方法可以帮助改进它。所有贡献都非常受欢迎！

个人贡献#

PyMC 是许多人共同努力的成果，每个人都在他们喜欢和擅长的领域做出贡献，并协调工作以覆盖所有任务。

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

提示

如果您想为项目做贡献但不确定从哪里开始或如何开始，请在 Discourse 上联系我们。

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

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

  • 通过在 Github 中提交 issue 来报告错误或提出改进建议

  • 在 Discourse 上回答问题

  • 通过撰写博客或发表演讲来教授有关 PyMC 的知识并宣传最佳实践

  • 协助规划 PyMCon

  • 协助外联和营销。例如，这可能包括联系潜在的赞助公司、可能在其工作中使用 PyMC 的人员，或确保使用 PyMC 的学者在其工作中正确引用它

  • 协助我们的筹款工作

  • 为 PyMCon 的视频添加时间戳

通过 GitHub 上的 Pull Request 贡献#

我们有一个 Pull request 步骤详解 和一个 Pull request 清单 页面，以帮助您完成贡献过程的所有步骤，从您第一次贡献到作为核心贡献者的定期贡献。

代码贡献的礼仪#

  • 当您开始处理 issue 时，请在您进行第一次提交后立即打开一个 Draft pull request（参见 Pull request 步骤详解）。

  • 在为新功能打开 PR 之前，请通过与维护者打开 issue 或 Discussion 来提出建议。根据提案，我们可能会将您引导至其他地方，例如 pymc-experimental 或 pymc-examples。

  • 任何没有打开的 pull request 的 issue 都可以进行处理。

    • 如果 pull request 没有最近的活动，则可能会被关闭，或被其他人接管。

    • “最近”的具体时间范围很难定义，因为它取决于贡献者、具体的代码更改和其他背景因素。作为经验法则，在没有其他障碍的正常 pull request 中，通常每隔几天就会有活动。

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

  • 如果不确定 issue 是否可用，请随时在 issue 中询问。 但请注意，根据前一点，打开的 pull request 是声明 issue 的方式。 请不要在 issue 中做出不切实际的承诺。

  • 如果您延迟了或需要休息一下都没关系，但如果您无法使其达到可以合并的状态，请在 pull request 中留下评论。根据更改（紧急错误修复与新功能），核心开发人员可以确定是否需要重新分配 PR 以完成工作。

机构贡献#

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

请通过 pymc.devs@gmail.com 联系 PyMC 以获取更多信息。