Github最新的Newsletter是关于新手参与开源的指南,写的非常不错,故将内容翻译如下:
1.选择一个项目:从你知道的开始
以下是几种入门方法:
- 为您使用的工具做出贡献:想想您日常使用的开源工具、库或应用程序。熟悉项目的目标和功能将有助于您自信地开始工作。您还可以访问github.com/explore,根据您过去的活动、星级和贡献获得个性化的项目建议。
- 按主题或项目集浏览:仍然一筹莫展?探索按主题分列的项目或浏览项目收藏。 找到符合您兴趣的内容。您是否喜欢机器学习? 或自然语言处理?甚至还有一个合集专注于如何选择(和贡献)您的第一个开源项目!
2.了解项目:先了解,再贡献
在不了解开放源代码项目的结构、规则或社区的情况下就贸然加入,感觉就像走进一场没有背景的对话。你可能有最好的意图,但如果你不了解项目的规范,你的努力可能会被忽视,甚至被拒绝。这就是为什么在贡献之前花一些时间熟悉项目是如此重要的原因。
下面介绍如何阅读房间并以正确的方式开始:
- README.md: README 是项目介绍。它解释了项目存在的原因、项目的作用以及如何开始。
- CONTRIBUTING.md: 该文件概述了如何贡献。其中可能包括编码标准、提交指南以及维护者希望如何接收贡献。
- CODE_OF_CONDUCT.md: 行为准则(CoC)规定了对社区行为的期望,并提供了如何报告事件的信息。拥有 CoC 意味着项目重视不同的观点,并鼓励相互尊重的合作。
- LICENSE.txt: 许可证决定了项目代码的使用、修改和再发布方式。如果一个项目没有许可证,那么它在技术上就不是开源的。
- 加入讨论: 许多项目都有论坛、同步聊天频道(如 Slack 或 Discord)或邮件列表。阅读最近的帖子,了解正在发生的事情。
3.找到自己的位置:贡献超越代码
当您在寻找第一个贡献时,不要过于执着于您需要贡献代码的想法。非代码贡献是项目成功的关键,也是参与项目的绝佳方式。更何况,有些维护者甚至不需要代码贡献!
以下是一些无需编写代码就能做出贡献的最有影响力的方法:
文档:根据2021 Octoverse 报告,良好的文档可以将工作效率提高 50%。您可以澄清易混淆的文本,帮助编写新功能的文档,并分享您的知识。 设计:强有力的视觉识别标志着一个项目的健康和专业性。但并不是每个人都具备创建视觉效果、徽标或改善用户体验的设计技能。 错误报告和测试: 错误报告和测试对于维护人员来说非常宝贵……不过也别忘了告诉他们哪些地方做得很棒! 社区参与:活跃的社区可促进合作与发展。通过帮助回答问题、培养新的贡献者,甚至主持讨论来参与其中。


4.迈出第一步:参与并做出贡献
一些最有价值的贡献是一点一滴改进项目的小规模、渐进式修改。修正错别字、报告错误或改进文档都是很好的入门方法。
以下是如何找到您的第一笔捐款:
- 好的第一个问题:查找标有 "好的第一个问题 "的问题。这些是维护者确定的适合初学者的任务。在任何项目的 URL 中添加 /contribute 即可轻松找到它们。例如,请访问 github.com/nodejs/node/contribute 查看 Node.js 项目的新手友好任务。
- 错误报告:如果您发现有问题,请提交详细的问题。请描述问题,包括重现问题的步骤,并解释您预期会发生什么。
确定自己的贡献后,让维护者知道您想解决某个问题。他们可能会提供指导,或者确认没有其他人在处理这个问题。之后,剩下的就是实际工作了!
开放源代码依赖于像您这样的人,无论是编写文档、提交代码还是报告错误,每一份贡献都很重要。您不仅能增长技能、建立联系,还能产生影响。快来参与吧!
PR中见!

原内容由 Mike Melanson 撰写,Gwen Davis 制作