Versun

对待生命,不妨大胆一点,因为我们终将失去它



刚接触开源?你并不孤单。

2025-01-13
Github最新的Newsletter是关于新手参与开源的指南,写的非常不错,故将内容翻译如下:
1.选择一个项目:从你知道的开始
以下是几种入门方法:
-7970374a.png 687 Bytes
专业建议:选择一个你真正感兴趣的项目。当你关心工作时,就更容易保持参与并做出有意义的贡献。
-1b154e67.png 423 Bytes
For Good 第一期:介绍一种新的贡献方式
2.了解项目:先了解,再贡献
在不了解开放源代码项目的结构、规则或社区的情况下就贸然加入,感觉就像走进一场没有背景的对话。你可能有最好的意图,但如果你不了解项目的规范,你的努力可能会被忽视,甚至被拒绝。这就是为什么在贡献之前花一些时间熟悉项目是如此重要的原因。
下面介绍如何阅读房间并以正确的方式开始:
  • README.md: README 是项目介绍。它解释了项目存在的原因、项目的作用以及如何开始。
  • CONTRIBUTING.md: 该文件概述了如何贡献。其中可能包括编码标准、提交指南以及维护者希望如何接收贡献。
  • CODE_OF_CONDUCT.md: 行为准则(CoC)规定了对社区行为的期望,并提供了如何报告事件的信息。拥有 CoC 意味着项目重视不同的观点,并鼓励相互尊重的合作。
  • LICENSE.txt: 许可证决定了项目代码的使用、修改和再发布方式。如果一个项目没有许可证,那么它在技术上就不是开源的。
  • 加入讨论: 许多项目都有论坛、同步聊天频道(如 Slack 或 Discord)或邮件列表。阅读最近的帖子,了解正在发生的事情。
-bcc441e6.png 687 Bytes
专业提示:如果一个项目缺少许可证,也许你可以帮助选择合适的许可证
-1dd2a3ae.png 423 Bytes
如何为项目定位
3.找到自己的位置:贡献超越代码
当您在寻找第一个贡献时,不要过于执着于您需要贡献代码的想法。非代码贡献是项目成功的关键,也是参与项目的绝佳方式。更何况,有些维护者甚至不需要代码贡献
以下是一些无需编写代码就能做出贡献的最有影响力的方法:
  • -9499e68a.png 714 Bytes
    文档:根据2021 Octoverse 报告,良好的文档可以将工作效率提高 50%。您可以澄清易混淆的文本,帮助编写新功能的文档,并分享您的知识。
  • -44c1fb20.png 809 Bytes
    设计:强有力的视觉识别标志着一个项目的健康和专业性。但并不是每个人都具备创建视觉效果、徽标或改善用户体验的设计技能。
  • -7f76f84b.png 998 Bytes
    错误报告和测试: 错误报告和测试对于维护人员来说非常宝贵……不过也别忘了告诉他们哪些地方做得很棒!
  • -f2021334.png 824 Bytes
    社区参与:活跃的社区可促进合作与发展。通过帮助回答问题、培养新的贡献者,甚至主持讨论来参与其中。
-6e357ad5.png 687 Bytes
专业建议:非代码贡献并不一定是非技术性的。测试或文档等任务通常需要对代码库有深入的了解。
-93fabcda.png 423 Bytes
非代码贡献如何成为开源成功的秘诀
4.迈出第一步:参与并做出贡献
一些最有价值的贡献是一点一滴改进项目的小规模、渐进式修改。修正错别字、报告错误或改进文档都是很好的入门方法。
以下是如何找到您的第一笔捐款:
  • 好的第一个问题:查找标有 "好的第一个问题 "的问题。这些是维护者确定的适合初学者的任务。在任何项目的 URL 中添加 /contribute 即可轻松找到它们。例如,请访问 github.com/nodejs/node/contribute 查看 Node.js 项目的新手友好任务。
  • 错误报告:如果您发现有问题,请提交详细的问题。请描述问题,包括重现问题的步骤,并解释您预期会发生什么。
确定自己的贡献后,让维护者知道您想解决某个问题。他们可能会提供指导,或者确认没有其他人在处理这个问题。之后,剩下的就是实际工作了!
-b6f2ecb4.png 687 Bytes
专业提示:由于您无论如何都需要阅读文档,因此这是一个完美的入门场所,同时还可以提交错误报告。这些低风险的贡献可以帮助您熟悉项目的工作流程。
-dfa971fa.png 423 Bytes
分步指南:首次贡献
开放源代码依赖于像您这样的人,无论是编写文档、提交代码还是报告错误,每一份贡献都很重要。您不仅能增长技能、建立联系,还能产生影响。快来参与吧!
PR中见!
-a712a4e4.png 752 Bytes
开始使用 GitHub Explore
原内容由 Mike Melanson 撰写,Gwen Davis 制作