166 Star 420 Fork 1.4K

openEuler/community

 / 详情

如何改善社区仓库 PR 以及 issue 处理不及时的问题

已完成
任务 成员
创建于  
2021-08-17 16:08

随着 openEuler 社区的发展,目前社区开发者已经从最初的部分早期参与的少量机构扩充为具有 88 个 SIG 组和 6056 个社区开发者。在参与社区的过程中,时常遇到 PR 处理不及时的问题,对社区开发者参与社区贡献造成困扰。

典型问题如下:

  1. https://gitee.com/src-openeuler 组织下当前有 1832 个 open 的 PR,总共有 92 页,第 10 页就已经是 18 天前创建的 PR,进入看留言就会有很多是没有 maintainer 在处理的。
  2. https://gitee.com/openeuler 组织下当前有 259 个 open 的 PR,依旧很有多是一个月以上没有处理的。
  3. 可以看到很多 PR 是没有指定 Reviewer 的,因为跟认识的社区提交着了解下来,很多提交者(无论是学生、参与社区的新人还是已经在社区贡献有几个月的贡献者)都不清楚该找谁 Review 。
  4. 有的时候 maintainer 看到了,回复了问题,提交者修改提交 commit 后,maintainer 并不是收到通知邮件(这个可能是 gitee 的设置问题?),需要提交着主动在留言处 @ ,maintainer 才能收到邮件提醒。
  5. 近期还遇到一位开发者一年前提交的 PR 没有被合并,在他之后提交基本相同的 PR 却被合并了,让开发者十分困惑。

在此列出了一些发现的问题,初步分析有以下原因:

  1. 仓库的 maintainer 收不到提醒邮件处理 PR
  2. 开发者不知道对应仓库的 maintainer 是谁
  3. 即使根据社区列表找到了 maintainer ,也会遇到很长时间 maintainer 都没有响应
  4. maintainer 实际参与社区的情况有变动,而在社区 maintainer 列表中并没有及时维护
  5. 缺乏良好的沟通渠道,时常收到别人咨询这个 SIG 谁负责,该找谁,怎么联系的问题

issue 的处理与 PR 有类似的问题。

因此发起这个议题,一方面收集大家遇到的问题和原因,另一方面讨论后续改善的措施。

评论 (4)

Jianmin 创建了任务 4年前
Jianmin 关联仓库设置为openEuler/community 4年前
展开全部操作日志
openeuler-ci-bot 添加了
 
sig/sig-Community
标签
4年前
Jianmin 修改了描述 4年前

可能的措施:

  1. 及时提醒仓库对应的 maintainer 处理 PR。
    • 比如参考 community 的 PR bot,自动添加评论 @ 相关的 maintainer
  2. 改进的查看 SIG 相关信息/沟通方式,以及 联系 maintainer 的帮助文档
    • 目前操作或许可以进一步改进,需要根据 PR 添加的 label 标签,到社区主页上搜索 SIG ,然后看 maintainer 列表
  3. 监督 SIG 组和 maintainer 对于消息处理的情况,如果未能及时响应,有其他机制督促提醒。
  4. 改进如何参与社区讨论、如果与社区沟通的文档

issue 应对策略建议:
细分仓库,仓库 maintainer 负责对应仓库的处理,权责清晰。
该仓库为例,该仓库有很多不同内容,容易造成困惑,应该把不同的内容拆分。简单的,可以将包引入相关的单独建仓来处理,而相关 maintainer 只需要关注对应仓库就行。在不涉及该仓库的代码的情况下,提供一个拆分逻辑,如果一件事特别多,就让这件事单独设一个仓库,这主要是降低 maintainer 的心智负担。

PR 应对策略建议:
完善文档,大量仓库的 readme 文档停留在模板阶段,如果有相关信息,也不至于找不到 maintainer 吧。做好配置,配置好 email 的提醒。

对于 issue 和 pr 在社区基建方面还可以这样做:

  1. 构建 bot 打通 gitee 和我们常用的即时沟通软件或 Email。
    可以构建 bot,如果 gitee 上有指定事件发生,可以同步到即时聊天软件上,让 maintainer 第一时间获取相关动态,或者第一事件收到邮件。如果 24 小时没有处理相关事件,就敦促提醒。
  2. 收集数据,形成看板,发现问题。
    可以收集相关数据 issue 回复时间、关闭时间...对这些数据进行分析,发现隐藏问题,及时处理。

此 issue 的相关问题已经做了持续改进。

Jianmin 任务状态待办的 修改为已完成 2年前

登录 后才可以发表评论

状态
负责人
项目
里程碑
Pull Requests
关联的 Pull Requests 被合并后可能会关闭此 issue
分支
开始日期   -   截止日期
-
置顶选项
优先级
预计工期 (小时)
参与者(3)
5329419 openeuler ci bot 1632792936 5420022 jianminw 1736235438 stevending1st-stevending1st
Go
1
https://gitee.com/openeuler/community.git
git@gitee.com:openeuler/community.git
openeuler
community
community

搜索帮助