入门

选择一个项目来参与#

如何选择哪个项目来贡献?没有一个最好的选择项目方法,但这里有一些选择时需要考虑的问题

  • 是否有与您的背景或研究相关的项目? 例如,天文学家可能更喜欢贡献到 astropysunpy
  • 是否有您正在使用的包? 即使是像 numpyscipymatplotlib 这样完善的通用包,仍在不断发展和变化,需要贡献者。
  • 该项目是否处于积极开发中? 查看项目的代码库,看看上次更新的时间以及有多少人参与。
  • 社区是否健康? 项目维护者将审查您的工作并指导您完成贡献过程,因此请查看项目拉取请求页面上的互动是否礼貌且友好。

最后一个提示是查看项目的开放问题,看看是否有任何标记为“简单”或“新手友好问题”,如果有,看看其中是否有您感兴趣的。

有关更详细的讨论,请查看我们下面的 选择项目 视频。

行业工具#

与任何行业一样,您需要学习某些基本工具。由于该生态系统是使用 Python 构建的,因此您需要了解如何使用该语言进行编程。我们每天使用的其他工具包括

  • git 和 GitHub
  • 命令行终端,以及
  • 一个纯文本编辑器或 集成开发环境 (“IDE”)。

在本视频系列中,使用这些工具的基础知识将在整个过程中介绍。要了解更多信息,请查看下面的链接

第一次贡献#

现在您已经选择了一个项目来贡献,是时候开始设置了。许多项目在代码库的根目录中有一个名为 CONTRIBUTING 的文件,它将告诉您如何设置开发环境、提出更改等。大多数项目在其网站上也都有一个名为“开发者文档”或“贡献者指南”的页面,其中包含类似的信息,通常还解释了测试和审查流程,以及您需要了解的其他内容。

首次贡献项目时,最好从小的、独立的问题开始。好的第一个问题示例包括修复一个小错误、添加测试、修复文档错别字或编写简单的文档。如果您还没有找到要处理的问题,现在是时候了(请记住,如果项目有“新手友好问题”标签,请寻找它)。

在进行第一次贡献时遇到问题并不少见。别慌!尝试找到项目的实时聊天或讨论论坛,在那里寻求帮助。维护者很乐意帮忙!

有关更多详细信息,请查看我们的 第一次贡献 视频。

下一步#

一旦您习惯了对项目进行小的更改,就可以开始进行更大的贡献。有很多不同的方法可以提供帮助:例如,您可以实现新功能、编写文档、重构和清理代码、改进测试、处理构建基础设施等等。

无论您贡献了什么,无论您的贡献大小,我们都非常感谢。

在此页面上