更多信号,更少噪音:GitHub 问题评论如何帮助确定优先级
您知道吗?自项目启动以来,OpenTelemetry 已经拥有超过 23,000 名贡献者——这些人包括在 GitHub 上分享问题、提交代码、进行拉取请求或评论的个人。我们始终鼓励每个人参与进来,无论您是加入我们(众多!)的 CNCF Slack 频道,还是参与任何 公开会议 来倾听并分享不同的观点。这种开放性是我们最大的优势之一,但也意味着我们通过多种渠道接收大量反馈:GitHub、Slack、StackOverflow、会议,甚至是社交媒体上的帖子。
作为该项目活跃的参与者,并且每天都与最终用户打交道,我看到了贡献的两个方面。用户提交 GitHub 问题,希望修复 bug 或实现新功能,而维护者则要浏览大量的通知,试图弄清楚在哪里最有效地利用他们有限的时间。为了让您了解规模,仅在 2024 年,整个项目关闭的 GitHub 问题数量就超过了 7,000 个!
在一个如此活跃的项目中,最大的挑战之一始终是了解 OpenTelemetry 用户和贡献者认为最重要的事情是什么。而且,当我们考虑 GitHub 问题时,一连串的“+1”或“我也是!”评论并没有让事情变得更容易。虽然这种情感是宝贵的,但这种方式会产生很多噪音,并使维护者更难评估有多少人**真正**受到某个问题的影响。
我们希望让每个人都更轻松。因此,作为终端用户 SIG 的一部分,我们一直在努力对我们使用 GitHub 的方式进行一项微小但重要的改变:**推广使用 👍 问题评论作为表达兴趣的主要方式。**
更好的信号,帮助确定优先级
这里的目标很简单:为社区提供一种清晰、低成本、数据驱动的方式来表明什么最重要。对于维护者而言,这个系统可以减少通知的噪音。他们可以按评论计数对问题进行排序,快速概览社区最迫切的需求。这有助于 SIG 和维护者在确定积压工作优先级时做出更明智的决定。
对您——最终用户而言,这意味着您的反馈更加可见。您的“+1”评论不再会淹没在长串的回复中,您的 👍 会成为一个可量化的数据点,有助于为该问题增加权重。
为了让这项改变得以持续,我们已经推出了一些措施。我们发布了针对 OpenTelemetry 维护者的建议,指导他们如何管理和解读这些评论,并且我们的网站现在有一个部分解释这对终端用户意味着什么。您还将在所有 OTel 存储库的问题模板的新脚注中看到一个友好的提醒。如果您正在打开一个新问题,请保留该页脚,以便其他人能够直接访问这些建议。
快速指南,助您产生影响
那么,这在实践中对您意味着什么?很简单。
下次浏览问题时,不要仅仅阅读并离开。当您找到一个描述您也遇到的问题或您希望看到实现的功能时,**只需给问题描述一个 👍 评论**。就是这样。点赞并订阅。这就是信号。
当然,如果您有新的、独特的用例、尚未提及的技术细节,或者有助于维护者解决问题的其他信息,那么请务必留下评论。这种背景信息非常有价值!请记住,高评论数是一个强烈的信号,但它并不能自动保证某个问题成为最高优先级。
开源是一项团队运动,这是一个很好的例子,说明小小的行动如何能够集体产生巨大的影响。
感谢您与我们一起,共同让 OpenTelemetry 变得更好。