主要观点:开源项目发展中,维护者常因大量 pull 请求而应接不暇,高质量的沟通技能教学能改善这一状况,以 Zulip 为例,介绍了教授良好沟通技能的方法,包括编写详细精确的文档、提供清晰可操作的反馈以及迭代改进文档等。
关键信息:
- 开源项目中维护者易被 pull 请求淹没,教学沟通技能可改善。
- Zulip 项目通过投资教学沟通技能,让 125 位贡献者与 13 位工程师协同工作。
- 教授沟通技能的三部分方法:写详细文档、提供反馈、迭代改进。
- 详细文档要清晰直接,具体说明对可审查工作的要求等。
- 提供反馈要专业尊重、适度指导、聚焦清晰传达。
- 迭代改进文档要根据反馈模式更新,节省时间。
重要细节: - 写文档初期不必追求完美,可逐步迭代。
- 提供反馈先关注沟通,再处理代码,节省时间且利于后续审查。
- 文档变长后,贡献者不必全部读完,只需链接到相关解释。
- 工作永无止境,持续改进,后续会探讨其他方面。
- 作者 Alya Abbott 自 2021 年起在 Zulip 领导相关工作,Karl Stolley 从事相关研究和写作。
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。