为开源项目做贡献是许多程序员的目标。带有“good-first-issue”标签的问题是寻找工作机会的一种方式。
当新人(从未对项目做出贡献的人)浏览 repo 中的问题时,GitHub 会向他们显示一条横幅“如果您准备好解决一些未解决的问题,我们为您收集了一些不错的首要问题。”,这将带您进入一个使用标签good-first-issue
过滤的问题页面。
可以把这个页面想象成你的代码库面向新人的登陆页面,因为它几乎是人们在想要贡献代码时首先会查看的内容(大多数代码库也会在CONTRIBUTING.md
中链接此页面)。但我发现这个页面在大多数情况下根本没什么用。通常它充斥着以下几种类型的问题:
陈旧的问题
不再需要实施,但没有人愿意更新该问题。
无人关注的问题
有一个 PR (或多个) 与该问题相关,但无人关注。
模糊语境
这个问题写得好像新手应该能理解很多背景信息似的。有人问了个澄清问题,却没人回答。
问题不是工作完成的方式而是 repo
通常这是最相关的因素,因为 GitHub 的问题很烦人。GitHub 上有很多开发者在开发一些非 GitHub 的东西(Discord/电子邮件/其他方式),而问题正是最终用户来报告 bug 或功能请求的地方。
我不知道开始贡献的最佳方式是什么,或许还是浏览这个页面吧,我只是希望更多项目能花时间让这个页面更有用。当你创建“优秀的第一期”时,就把它当成一种回馈。你和一个脆弱的新手签订了一份合同;要精准、乐于助人、谦逊。
原文: https://am17an.bearblog.dev/why-good-first-issues-are-usually-not-good-first-issues/