关于确保新贡献者拥有积极体验的 5 步计划

还没有读者喜欢这个。
Two different business organization charts

Opensource.com

《大教堂与集市》中,埃里克·S·雷蒙德提出了“只要有足够多的眼睛,所有 bug 都是肤浅的”的观点。这是一种很好的想法,但是当一个新项目启动时,获得并保持足够多的关注可能很困难。你的第一个项目版本已经上传到 GitHub;你一直在推广它,并且有一些新的贡献者加入进来。现在,你如何留住他们?

在他在 OSCON 上的演讲《优化你的项目以促进贡献》中,Mozilla 的平台开发人员 Joshua Matthews 给出了一个五步计划,以确保新贡献者在加入新的开源开发项目时拥有积极的体验。

1. 优先考虑有用的信息

拥有一个维基,其中包含新贡献者手头需要的信息,这是一个绝佳的方法。确保你在首页回答了“我如何使用它?”“我如何更改它?”和“我在哪里可以获得帮助?”这些关键问题。使用链接深入了解更深层次的技术信息。

对于更高级的贡献者,路线图和推荐的工作流程是不错的主意,描述贡献接受要求的文件也是如此。Nadia Eghbal 创建了一个 出色的模板 用于贡献指南,该模板已获得 CC0 许可,因此你可以将其免费用于任何目的。

对于专家,请考虑诸如变更日志、FAQ、发行说明和拉取请求模板之类的文档。

你永远不应该做的一件事是将他们发送到你的 bug 跟踪器。说“在 bug 跟踪器中找到一些工作要做”是赶走新贡献者的最快方法之一。Bug 跟踪器可能充满了技术术语和文化或领域知识的流行语,这是新的编码人员无法理解的。某些问题跟踪器(例如 GitHub 中的问题跟踪器)允许你将某些问题标记为适合新手,你应该绝对使用这些标记!

2. 减少摩擦

如果你的项目有冗长的安装说明且无法正常工作,你将很快赶走人们。一个更好的主意是使用安装脚本。此外,虽然能够在任何平台上破解你的项目是一个美好的想法,但指定一个标准的编码环境将有助于新手快速参与进来。想要在非标准平台上工作的编码人员要么足够专业,要么足够坚定,可以弄清楚如何操作,而其余的大多数人会选择使用标准平台。

自动向你的核心团队发送有关新贡献的通知也是减少摩擦的方法;它有助于更快的响应,从而鼓励贡献者继续学习和工作。

3. 明确你的期望

你可以通过使用优先排序的文档来明确你对新团队成员的期望,从而使新贡献者更加满意:他们需要知道什么?获得或提供反馈应该花费多长时间?项目里程碑和截止日期是什么(如果有)?他们被分配的任务有多困难?

另一个重要的期望是让你的贡献者知道社区可以接受的行为。为此,行为准则是使其明确化的一个非常简单的方法。在线存在许多模板和示例,因此你不必从头开始编写。

4. 适当回应

始终确保最大限度地减少提供反馈所需的时间。没有什么感觉比等待回复更糟糕的了,尤其是对于首次贡献者而言。如果更改不符合团队的标准,请不要直接驳回它。务必引导它完成达到合格标准的修改。始终解释为什么更改可能不受欢迎,并务必感谢他们!

当你与新贡献者合作时,请注意诸如“只是”、“容易”和“简单”之类的含糊措辞。虽然该任务对你来说可能很容易,但对他们来说不一定如此,这会贬低他们的努力。确保他们知道他们可以提出问题,并跟进一个问题,例如“这有道理吗?”,因为它使他们有机会提出澄清问题。在谈论团队时,请使用诸如“我们”和“我们的”之类的包容性词语。

5. 贯彻始终

始终确保公开表彰你的新贡献者。向团队列表发送电子邮件、在 IRC 上发布公告或在项目文档中添加他们到贡献者列表的提交,将建立他们的信心并鼓励他们留在团队中。始终记住,每个贡献者都可能是潜在的维护者或发布经理。

在你的项目生命周期的早期设置的一些结构性事项可以长期帮助贡献者。其中一些事情有些耗时,而另一些则只是简单的礼貌。从长远来看,你可能会发现所有这些对于你的贡献者社区的活力都是值得的。

User profile image.
Ruth Holloway 长期以来一直担任系统管理员和软件开发人员,她的职业生涯开始于很久以前的 VAX 11/780。她职业生涯的很大一部分(到目前为止)都在为图书馆提供技术需求服务,并且自 2008 年以来一直是 Koha 开源图书馆自动化套件的贡献者。Ruth 目前是 Clearbuilt 的 Perl 开发人员和项目负责人。

评论已关闭。

Creative Commons License本作品根据 Creative Commons Attribution-Share Alike 4.0 International License 获得许可。
© . All rights reserved.