如何为 OpenTelemetry 做贡献
您可能听说过 OpenTelemetry,觉得它很有趣并想参与其中,但贡献之路并不总是很清晰。您可能会开始联系人们,请求分配问题,或者只是喊一嗓子“我来帮忙,告诉我做什么”,但却石沉大海。那么,您如何才能真正开始为 OpenTelemetry 做贡献呢?
开源项目蓬勃发展于社区、相互支持和协作式技术创新。但它也伴随着挑战,尤其如果您是这个生态系统的新手。
开源贡献动态
在开源项目中,您是自己贡献之旅的建筑师。没有人会分配任务或指导您的每一步。相反,您需要主动出击,识别需要帮助的领域,并主动去完成它们。
至关重要的是要理解,开源贡献与传统的工作不同,在传统工作中,经理或技术主管会分配任务。在开源项目中,工作内容的决定权在于您自己。
确定您的贡献领域
您可能出于多种原因想要做出贡献:开发组织所需的关键功能;修复您正在使用的组件中的 bug;学习新技能并扩展知识体系;成为一个充满活力、协作的社区的活跃成员;扩展您在科技行业的人脉等等。
首先,探索 OpenTelemetry 中与您现有专业知识相符或激发您好奇心的领域。OpenTelemetry 是一个庞大的项目,包含众多组件、各种编程语言以及跨越不同复杂程度的功能。考虑哪些最能引起您的共鸣。
此页面列出了所有现有的 SIG(特别兴趣小组)及其各自的 Slack 频道和会议时间:SIGs。您也可以订阅 OpenTelemetry 日历,并查看您感兴趣的会议:Calendar。
虽然选择活跃的仓库可能很诱人,因为您可能会更快地收到 PR 的反馈和问题解答,但不要忽视不太活跃的仓库,因为它们确实会受益于人们的帮助。如果您的长期目标是达到“Approver”或“Maintainer”之类的身份,那么为不太活跃的仓库做贡献可以加速这一进程,因为您的贡献将产生更大的影响。在此处了解更多关于成员身份的信息:Membership。
对于新来者来说,在这些仓库中查找标记为“good first issue”的问题是一个绝佳的策略。这些问题通常设计得易于新贡献者上手,为进入项目提供了一个可管理的切入点。
如果您不确定从哪里开始贡献,文档是一个很好的起点,因为它直接造福于广大受众。您可以在此处查看有关如何为文档做贡献的更多详细信息:Contributing,其中包含本地化的努力。
另一个很好的起点是加入 OpenTelemetry 的某个特别兴趣小组 (SIG)。这些小组专注于项目的特定领域。通过沉浸在 SIG 中,您将深入了解他们当前的优先事项并识别相关任务。请不要觉得您需要立即在会议上发言,没有压力!如果您愿意,可以介绍自己,但通常您可以只加入、倾听,并确定该领域是否令您感兴趣。如果令您感兴趣,您就可以开始参与讨论或提出自己的话题。
实质性贡献
如果您正在考虑进行更实质性或创新的贡献,建议与相关 SIG 的维护者进行咨询。他们可以提供宝贵的意见,并帮助确定您提议的任务是否与当前项目目标一致,以及在当前时刻是否适合您执行。
所有 OpenTelemetry 仓库都可以在 OTel Repositories 找到。此页面提供了每个仓库的概述,包括使用的编程语言和简要描述。
大多数 OpenTelemetry 仓库都包含一个“contributing”选项卡。此选项卡提供了特定于仓库的指导,涵盖了依赖项、本地运行测试的说明以及其他设置过程等基本信息。如果您在这些贡献文档中发现任何遗漏的信息,请随时在相应的 Slack 频道上提问。
在您的贡献过程中,您可能会发现现有贡献文档中的不足或需要改进的地方。这为您提供了一个宝贵的机会,可以通过创建 pull request 来添加缺失的信息。通过这样做,您不仅为项目做出了贡献,还将极大地帮助未来可能遇到类似问题的贡献者。文档贡献与代码贡献同样重要。
最后的思考
一旦您决定要处理什么,随时可以寻求帮助,请记住,OpenTelemetry 社区是一个强大的资源,有很多人愿意提供指导。
如果您对如何改进 OpenTelemetry 贡献者的整体体验有任何想法,我们鼓励您在 Slack 频道 #otel-contributor-experience 上分享。您的建议非常有价值,可以帮助塑造一个对所有参与者更友好、更高效的环境!
祝您编码愉快!