如何使审查拉取请求成为更好的体验

主要观点:开源项目发展中,维护者常因大量 pull 请求而应接不暇,高质量的沟通技能教学能改善这一状况,以 Zulip 为例,介绍了教授良好沟通技能的方法,包括编写详细精确的文档、提供清晰可操作的反馈以及迭代改进文档等。
关键信息

  • 开源项目中维护者易被 pull 请求淹没,教学沟通技能可改善。
  • Zulip 项目通过投资教学沟通技能,让 125 位贡献者与 13 位工程师协同工作。
  • 教授沟通技能的三部分方法:写详细文档、提供反馈、迭代改进。
  • 详细文档要清晰直接,具体说明对可审查工作的要求等。
  • 提供反馈要专业尊重、适度指导、聚焦清晰传达。
  • 迭代改进文档要根据反馈模式更新,节省时间。
    重要细节
  • 写文档初期不必追求完美,可逐步迭代。
  • 提供反馈先关注沟通,再处理代码,节省时间且利于后续审查。
  • 文档变长后,贡献者不必全部读完,只需链接到相关解释。
  • 工作永无止境,持续改进,后续会探讨其他方面。
  • 作者 Alya Abbott 自 2021 年起在 Zulip 领导相关工作,Karl Stolley 从事相关研究和写作。
阅读 4
0 条评论