身为一名维护者意味着什么?

如果你维护着一个非常流行的项目,你可能就会意识到自己写代码的时间变少,而花费在回答issue的时间越来越多。

在项目的起步阶段,你会不断尝试着实现自己的新想法,也能够基于自己想要的作出决定。随着项目逐渐的开始流行,就会发现你的大部分时间都花在了与用户、贡献者打交道上。

维护一个项目需要的不仅仅是写代码的能力。有些时候会有一个你意想不到的的事情要应付,但是这对一个项目的成长也很重要(相对于代码来说),我们收集了一些小技巧来让你的维护工作变得稍轻松些,这些技巧,涉及范围颇广,从写文档到管理社区都有所涉猎。

将流程撰文档化

对于一个项目的维护者来说写文档是最重要的事情之一。

文档不仅说清楚了你的想法是什么,而且还帮助别人在问问题之前理解你需要什么和接下在希望做什么。

将一些东西写下来,当遇到不符合项目预期的内容时,可以轻松的拒绝。同时,它对于人们的参与和提供帮助提供了指导。最有意思的是,撰写文档的人可能永远也不知道是谁读了他写的文档,或者使用项目。

即使你不想长篇大论,对要点略说一二也比啥都不写要好。

写下你的项目的发展方向

请在项目启动时就写下项目目标,并将之加到 README 文件中, 或者创建一个单独的 VISION 文件,其它还能帮助人们了解这方面的信息如项目管理路线图,最好是也把他们公开。

有一个明确的,用文档表达清晰的愿景,能保证项目的走向不会跑偏,同时也能保障因为其他的贡献者增加的奇怪的需求而使项目变质。

比如,@lord 发现项目有一个明确的愿景能够帮助他决定哪个 PR 值得花时间。作为一个维护者的新手,他甚至还后悔当他接到第一个关于slate)PR的时候没有坚持项目本身的原则。

和大家交流你自己对项目的期望

制定规则是很伤脑筋的。有时候你可能觉得你像是在限制别人的行为或者说把好玩的东西都搞没了。

制定了规则,然后严格执行,当然啦,好的规则会让维护者更轻松。他们会把你从做自己不愿意做的事情中解脱出来。

大多数知道你项目的人对你或者你的处境都是一无所知。他们可能会觉得你做这个项目是有钱拿的,特别是你的项目是他们经常用的而且某种程度上有点依赖的时候。其实你只是在有时候会在项目上花很多时间,但是现在你在忙着安置新工作或者照顾刚出生的儿子。

这些都是再正常不过的事情!所以确保让别人也知道这些。

如果你维护某个项目是利用空闲时间或者完全自愿的,能花多少时间就花多少时间。而不是你觉得项目需要你花多少时间或者别人想让你花多少时间。

这里是一些值得你写进项目里的东西:

  • 怎样的贡献才会被复查和接受(需要测试吗?提Issue有模板吗?)
  • 你本人会接受什么类型的贡献?(你是不是只希望在某些部分的代码上需要别人的帮助?
  • 在合适的时候跟进项目(比如说 如果你在七天之内没有收到maintainer的回复,而且依旧没有其它任何的响应,那么就直接找Ta。
  • 你会在这个项目上话多少时间(比如说 “我们每星期只会在这个项目上花5个小时“)

JekyllCocoaPods、以及 Homebrew 均是为维护者和贡献者提供了很好的基本规则的项目.乃业内典范。

保证交流是公开进行的

不管是什么时候,保证你的交流是在公共的场所(就是大家都能看到的地方)。如果有人尝试和你私聊,哪怕是讨论一个新的需求或者功能,请礼貌的引导Ta到公共的交流场所,比如邮件列表或者iuuse tracker。

如果你和别的维护者面基了,或者在私下做了一个很重要的决定,把这些信息告诉大家,即使只是把你的笔记发上去。

这样的话,每个人新加入到你们社区的人和已经呆了多年的人能够了解到的信息是一样的。

学会拒绝他人

把所有的事情都写下来,当然,对你执行你制定的规则的时候客观分析实际情况也有帮助。

拒绝别人确实不是很好玩,但是也要表现出专业程度,比如使用“你的贡献不符合这个项目的标准”而不是“我不喜欢你的贡献”这样显得粗鲁的语句。

作为一个维护者,在很多情况下,你都要拒绝别人:不符合项目规则的PR, 某个人脱离了讨论的重点,给别人做无关紧要的工作等等。

保持友好沟通

你要学会拒绝的最重要的地方就是Issue和PR请求。作为一个项目的维护者, 你会不可避免的收到你不想接受的建议。

可能某个贡献并不在项目的范围或者和你的期望不合。又或者是可能想法很好,但是实现的却很烂。

不管是什么原因,在处理这些不符合项目标准的贡献的时候都要婉转。

如果你收到了你不想接受的贡献,你的第一反应可能是忽略或者假装没看到。但是这么做会严重伤害到别人而且可能会让你社区里的其他贡献者失去动力。

别因为自己感到内疚或者想做一个好人就把你不想接受的贡献继续保留。随着时间的流逝,这些你没有回答的issue和PR会让你觉得很不爽。

更好的方式是马上关掉你不想接受的贡献。如果你的项目已经保守积压的issue的折磨,@steveklabnik 可以给你点儿建议,如何高效的解决issue

第二点,忽略别人的贡献等于是在社区传递了一个负面的信号。让人感觉提交一个贡献是蛮恐惧的事情,尤其是对于刚加入的新手来说。即使你不接受他们的贡献,告诉他们为什么然后致谢。这会让人觉得更舒服。

如果你不想接受某个贡献:

  • 感谢他们 的贡献
  • 解释为什么他们的贡献不符合 项目的需求范围,然后提供清楚的建议以供改善,如果你可以的话。和蔼一点,但同时也要讲原则。
  • 引用相关的文档, 如果你有的话。如果你发现你反复收到你不想接受的贡献,把他们加到文档以免你重复叙述。

你不需要用超过1-2两句话来回复。比如,当一个celery的用户报告了一个window相关的错误,@berkerpeksag这么回复的

celery screenshot

如果你感觉拒绝别人很不好意思,也很正常,其实很多人都是这样。就像 @jessfraz 说到的:

我和很多来自诸如Mesos, Kubernetes, Chromium等不同开源项目的维护者交流过,他们都异口同声的觉得做一个维护者最难的就是拒绝你不想要的补丁。

对于不想接受别人的贡献这件事不要感到愧疚。如 @shykes所说开源的第一原则就是 “拒绝是暂时的,接受是永远的。” 当然啦,认同别人的热情还是一件好事,拒绝他的贡献和拒绝他这个人是两码事。(要做到对事不对人。)

最后,如果一个贡献不是够好,你没任何义务接受它。对那些想对你的项目做贡献的人保持和蔼和积极的态度,但是只能接受那些你确定会让你的项目变得更好的提交。你说拒绝的次数越多,对你来说拒绝别人就越容易。谨记!

保持主动

要想减少你不想接受的贡献的数量,首先,在你项目的贡献指南中解释如何提交贡献以及怎样的贡献会被接受。

如果你收到太多低质量的贡献,让那个贡献者先多做做功课,比如:

  • 填写一个 issue 或者 PR 的模板/清单
  • 在提交PR之前先开一个 issue

如果他们不遵从你的规则,马上关掉 issue 并引用你的文档。

当然啦,这么搞一开始是不太舒服,但是你主动一点确实对双方都好。它减少了某个人花了太多时间到一个你不想要的 PR 上的可能性。而且让你管理起来更轻松。

有时候,当你说不的时候,你潜在的贡献者会感到对你的沮丧或者不爽。如果他们开始找你撕逼了,采取必要的措施以应对局势或者干脆把他们从你的社区开除,如果他们不打算和你保持建设性的合作关系的话。

成为导师

可能在你的社区里有人不断提交一些不符合项目需求的贡献。对你们双方来说,不停的拒绝他的提交,会令双方都很尴尬。

如果你发现有人对你的项目很上心,但是就是需要调教,那就耐心一点。给他解释明白每次它的提交为什么不符合项目需求。尝试着让他先做一些简单一点的事,比如那些标有_“good first bug”_ 标签的issue,以此让他慢慢习惯。如果你有时间的话,考虑教Ta怎么完成第一次贡献,或者在社区找一个人教Ta。

有效利用社区

你不需要凡事亲力亲为。这就是社区存在的原因!即使你没有一个活跃的贡献者社区,但是如果你有很多用户的话,拉他们来干活儿。

分担工作量

如果你正在寻找其他人来参与, 从身边的人开始。

当你看到新的贡献者不停的提交贡献,通过分配给他们更多任务来表示认可。如果别人愿意的话,记录下别人是怎么成长为领导者的过程。

鼓励别人来一起管理项目能很大程度上减轻你的工作量,就像 @lmccart在他的项目上做的那样,p5.js

如果你需要暂时或者永久的离开的项目,请找人来代替你,这并没有什么不好意思。

如果别人认同项目的发展方向,给他们提交的权限或者正式把项目所有权转移给他。如果有人fork了你的项目而且在保持活跃的维护中,考虑在你的原始的仓库放上这个fork版本的链接。如果大家都希望你的项目继续的话这不失为一种好办法。

@progruim 发现 由于它给他的项目Dokku写一个关于项目发展方向的文档,即使在它离开这个项目后他的那些目标仍然会被实现。

我写了一个wiki来描述我想要啥和为什么。不知道为啥,项目的维护者就开始推动项目朝这个方向发展,这对我来说还是有点惊讶的。他们会丝毫不差的按照我的意愿去做这个项目吗?不总是这样,但是总是会把项目推动到离我的理想状态更近的位置。

让别人尝试他们自己想要的解决方案

如果有贡献者关于项目有不同的意见,你可以礼貌的鼓励它在他自己fork版本上继续工作。

fork一个项目不什么坏事情。能复制并且修改别人的代码是开源项目最大的好处之一。鼓励你的社区成员在他自己fork的仓库上继续工作,这是在不和你的项目冲突的基础上,给实现他们的想法最好的出口。

这对于那些强烈的需要某个你没时间实现的解决方案的用户来说也是一样的。提供API或者自定义的钩子帮助他们更好的实现自己的需求而不需要改动源码。@orta发现鼓励在CocoaPods上使用插件导致了很多有趣的想法的诞生。

一旦一个项目变大之后,维护者对怎么增加新代码变得保守是不可避免的事情。你可能很会拒绝别人的需求,但是很多人提的都是合法的需求。所以,你不得不把你的一个工具变成平台。

使用机器人

就像很多工作别人可以帮你做一样,也有很多工作不需要人来做。因为有机器可以替代人工,尤其是那些重复、无聊的工作,用好它们能够让你的维护生活变得更容易。

引进测试和别的检查来改善你的代码质量

让你项目自动化的最重要的方法之一就是引进测试。

测试能够帮助贡献者自信他们没有弄坏什么。测试也让你复查代码和接受别人的贡献的过程更加容易。你反应的越多,社区参与的就越多。

设置自动化的测试让所有新来的贡献者都可用,而且保证你的测试可以很容易在贡献者的本地运行。保证所有的代码贡献者在提交之前都运行你的测试。你还得为所有的提交设置一个基本的标准。

如果你添加了测试,确保在 CONTRIBUTING 文件里面解释他们是怎么工作的。

用工具来自动化日常的维护工作

对于维护一个流行的项目来说,一个好消息是别的维护者也可能遇到过类似的问题而且已经找到一个解决方案。

这里有各种各样的工具帮你自动化一部分的维护工作。这里仅列举一些常见的例子:

对于bug报告和其他常见形式的贡献,Github有Issue 模版和 Pull Request 模版, 你可以用来降低沟通成本。你也可以设置邮件过滤来管理你的邮件提醒。

如果你想更加的先进和高效,代码风格指南和linter能让你项目收到的贡献更加规范,而且更容易复查和被接受。

当然啦,如果你的标准太复杂了,反倒会增加了贡献的难度。所以保证你只添加那些让每个人工作起来更容易的规则。

如果你不确定用什么工具,看一看别的流行项目是怎么做的,特别是和你在一个生态系统的。比如,其他的Node模块的贡献流程是怎么样的?用相似的工具和方法,能够让你项目的贡献流程对于开发者来说是很熟悉的。

不干了也没关系

开源项目曾经让你开心,但可能现在开始让你不开心了。

可能当你想到你的项目的时候感觉到”亚历山大”。而同时,issue和PR又纷至沓来。

疲倦在开源工作工作中是一个常见的问题,特别是在维护者中间。作为一个维护者,你做的开心对项目的生存来说是一个没有商量余地的条件。

虽然你不需要跟谁请假,但是也不要拖到自己疲倦不堪的时候才去度假。@brettcannon,一个python的核心开发者,决定在14年的义务劳动之后休一个月的假

就像其他工作一样,有规律的休息会让你对工作保持舒适愉快的心情。

有时候,当你感觉大家都离不开你的时候,请假去休息是一件蛮困难的事情。甚至你自己会因为离开而感到愧疚。

在你离开项目的时候尽可能的在用户和社区中间寻求支持,如果你找到支持你的人,还是休息吧。在你不工作的时候还是要保持和别人交流,这样人们不会因为你的失联而感到奇怪。

休假不仅适用于度假。如果你周末不想做开源项目的工作了,或者在本该工作的时候不想干活了,和别人说,这样他们知道什么时候不该打扰你。

首先照顾好自己!

维护一个大型项目时,相比早期的增长阶段,是需要更多的不一样的技能,作为一个维护者,你会将自己的领导力和个人能力提高一个层次,而这是很少人能体会的到的。但是与此同时,要挑战管理项目,以及设定清晰的界限。只做你感到舒服的事情,能够让你保持开心,活力,高产的状态。