@@ -17,15 +17,15 @@ related:
17
17
- leadership
18
18
---
19
19
20
- ## 身为一名维护者意味着什么?
20
+ ## What does it mean to be a maintainer?
21
21
22
22
如果你维护着一个非常流行的项目,你可能就会意识到自己写代码的时间变少,而花费在回答issue的时间越来越多。
23
23
24
24
在项目的起步阶段,你会不断尝试着实现自己的新想法,也能够基于自己想要的作出决定。随着项目逐渐的开始流行,就会发现你的大部分时间都花在了与用户、贡献者打交道上。
25
25
26
26
维护一个项目需要的不仅仅是写代码的能力。有些时候会有一个你意想不到的的事情要应付,但是这对一个项目的成长也很重要(相对于代码来说),我们收集了一些小技巧来让你的维护工作变得稍轻松些,这些技巧,涉及范围颇广,从写文档到管理社区都有所涉猎。
27
27
28
- ## 将流程撰文档化
28
+ ## Documenting your processes
29
29
30
30
对于一个项目的维护者来说写文档是最重要的事情之一。
31
31
@@ -45,13 +45,12 @@ related:
45
45
46
46
<aside markdown =" 1 " class =" pquote " >
47
47
<img src =" https://avatars2.githubusercontent.com/u/1976330?v=3&s=460 " class =" pquote-avatar " alt =" avatar " alt =" @lord avatar " >
48
- 我一直都在摸索。我没有努力寻求一个完整的解决方案。与其采用那种半吊子办法,我真希望曾经对某些Issue的提出者说:“ 我暂时没有时间干这个,但是我会把他放到我的待办事项中” 。
48
+ 我一直都在摸索。我没有努力寻求一个完整的解决方案。与其采用那种半吊子办法,我真希望曾经对某些Issue的提出者说:" 我暂时没有时间干这个,但是我会把他放到我的待办事项中" 。
49
49
<p markdown =" 1 " class =" pquote-credit " >
50
50
— @lord , [ "开源项目维护者新手的几点技巧"] ( https://lord.io/blog/2014/oss-tips/ )
51
51
</p >
52
52
</aside >
53
53
54
-
55
54
### 和大家交流你自己对项目的期望
56
55
57
56
制定规则是很伤脑筋的。有时候你可能觉得你像是在限制别人的行为或者说把好玩的东西都搞没了。
@@ -71,7 +70,6 @@ related:
71
70
* 在合适的时候跟进项目(比如说 _ 如果你在七天之内没有收到maintainer的回复,而且依旧没有其它任何的响应,那么就直接找Ta。_ )
72
71
* 你会在这个项目上话多少时间(比如说 "_ 我们每星期只会在这个项目上花5个小时_ ")
73
72
74
-
75
73
[ Jekyll] ( https://github.com/jekyll/jekyll/tree/master/docs ) 、[ CocoaPods] ( https://github.com/CocoaPods/CocoaPods/wiki/Communication-&-Design-Rules ) 、以及 [ Homebrew] ( https://github.com/Homebrew/brew/blob/bbed7246bc5c5b7acb8c1d427d10b43e090dfd39/docs/Maintainers-Avoiding-Burnout.md ) 均是为维护者和贡献者提供了很好的基本规则的项目.乃业内典范。
76
74
77
75
### 保证交流是公开进行的
@@ -82,11 +80,11 @@ related:
82
80
83
81
这样的话,每个人新加入到你们社区的人和已经呆了多年的人能够了解到的信息是一样的。
84
82
85
- ## 学会拒绝他人
83
+ ## Learning to say no
86
84
87
85
把所有的事情都写下来,当然,对你执行你制定的规则的时候客观分析实际情况也有帮助。
88
86
89
- 拒绝别人确实不是很好玩,但是也要表现出专业程度,比如使用“ 你的贡献不符合这个项目的标准” 而不是“ 我不喜欢你的贡献” 这样显得粗鲁的语句。
87
+ 拒绝别人确实不是很好玩,但是也要表现出专业程度,比如使用" 你的贡献不符合这个项目的标准" 而不是" 我不喜欢你的贡献" 这样显得粗鲁的语句。
90
88
91
89
作为一个维护者,在很多情况下,你都要拒绝别人:不符合项目规则的PR, 某个人脱离了讨论的重点,给别人做无关紧要的工作等等。
92
90
@@ -128,7 +126,7 @@ related:
128
126
129
127
> 我和很多来自诸如Mesos, Kubernetes, Chromium等不同开源项目的维护者交流过,他们都异口同声的觉得做一个维护者最难的就是拒绝你不想要的补丁。
130
128
131
- 对于不想接受别人的贡献这件事不要感到愧疚。如 [ @shykes ] ( https://github.com/shykes ) [ 所说] ( https://twitter.com/solomonstre/status/715277134978113536 ) 开源的第一原则就是 _ "拒绝是暂时的,接受是永远的。” _ 当然啦,认同别人的热情还是一件好事,拒绝他的贡献和拒绝他这个人是两码事。(要做到对事不对人。)
129
+ 对于不想接受别人的贡献这件事不要感到愧疚。如 [ @shykes ] ( https://github.com/shykes ) [ 所说] ( https://twitter.com/solomonstre/status/715277134978113536 ) 开源的第一原则就是 _ "拒绝是暂时的,接受是永远的。" _ 当然啦,认同别人的热情还是一件好事,拒绝他的贡献和拒绝他这个人是两码事。(要做到对事不对人。)
132
130
133
131
最后,如果一个贡献不是够好,你没任何义务接受它。对那些想对你的项目做贡献的人保持和蔼和积极的态度,但是只能接受那些你确定会让你的项目变得更好的提交。你说拒绝的次数越多,对你来说拒绝别人就越容易。谨记!
134
132
@@ -161,7 +159,7 @@ related:
161
159
162
160
如果你发现有人对你的项目很上心,但是就是需要调教,那就耐心一点。给他解释明白每次它的提交为什么不符合项目需求。尝试着让他先做一些简单一点的事,比如那些标有_ "good first bug"_ 标签的issue,以此让他慢慢习惯。如果你有时间的话,考虑教Ta怎么完成第一次贡献,或者在社区找一个人教Ta。
163
161
164
- ## 有效利用社区
162
+ ## Leverage your community
165
163
166
164
你不需要凡事亲力亲为。这就是社区存在的原因!即使你没有一个活跃的贡献者社区,但是如果你有很多用户的话,拉他们来干活儿。
167
165
@@ -171,14 +169,13 @@ related:
171
169
172
170
当你看到新的贡献者不停的提交贡献,通过分配给他们更多任务来表示认可。如果别人愿意的话,记录下别人是怎么成长为领导者的过程。
173
171
174
-
175
172
鼓励别人来[ 一起管理项目] ( ../building-community/#share-ownership-of-your-project ) 能很大程度上减轻你的工作量,就像 [ @lmccart ] ( https://github.com/lmccart ) 在他的项目上做的那样,[ p5.js] ( https://github.com/processing/p5.js?files=1 )
176
173
177
174
<aside markdown =" 1 " class =" pquote " >
178
175
<img src =" https://avatars3.githubusercontent.com/u/191056?v=3&s=460 " class =" pquote-avatar " alt =" avatar " >
179
- 我曾经说过,“ 对,每个人都可以参与进来,你不需要有很多编程的经验。” 当有申请来参加我们的活动的时候,我就在想,这是真的吗,我说了啥?有将近40个人来了,我虽然不可能和每个人都单独交谈,但是大家一起来了,这说明我说的没错。只要有人知道怎么做了,他们就能教他们的邻居。
176
+ 我曾经说过," 对,每个人都可以参与进来,你不需要有很多编程的经验。" 当有申请来参加我们的活动的时候,我就在想,这是真的吗,我说了啥?有将近40个人来了,我虽然不可能和每个人都单独交谈,但是大家一起来了,这说明我说的没错。只要有人知道怎么做了,他们就能教他们的邻居。
180
177
<p markdown =" 1 " class =" pquote-credit " >
181
- — @lmccart , [ "“开源” 意味着什么? p5.js 版"] ( https://medium.com/@kenjagan/what-does-open-source-even-mean-p5-js-edition-98c02d354b39#.chnjlag7p )
178
+ — @lmccart , [ ""开源" 意味着什么? p5.js 版"] ( https://medium.com/@kenjagan/what-does-open-source-even-mean-p5-js-edition-98c02d354b39#.chnjlag7p )
182
179
</p >
183
180
</aside >
184
181
@@ -208,7 +205,7 @@ fork一个项目不什么坏事情。能复制并且修改别人的代码是开
208
205
209
206
> 一旦一个项目变大之后,维护者对怎么增加新代码变得保守是不可避免的事情。你可能很会拒绝别人的需求,但是很多人提的都是合法的需求。所以,你不得不把你的一个工具变成平台。
210
207
211
- ## 使用机器人
208
+ ## Bring in the robots
212
209
213
210
就像很多工作别人可以帮你做一样,也有很多工作不需要人来做。因为有机器可以替代人工,尤其是那些重复、无聊的工作,用好它们能够让你的维护生活变得更容易。
214
211
@@ -230,7 +227,6 @@ fork一个项目不什么坏事情。能复制并且修改别人的代码是开
230
227
</p >
231
228
</aside >
232
229
233
-
234
230
### 用工具来自动化日常的维护工作
235
231
236
232
对于维护一个流行的项目来说,一个好消息是别的维护者也可能遇到过类似的问题而且已经找到一个解决方案。
@@ -257,7 +253,6 @@ fork一个项目不什么坏事情。能复制并且修改别人的代码是开
257
253
258
254
疲倦在开源工作工作中是一个常见的问题,特别是在维护者中间。作为一个维护者,你做的开心对项目的生存来说是一个没有商量余地的条件。
259
255
260
-
261
256
虽然你不需要跟谁请假,但是也不要拖到自己疲倦不堪的时候才去度假。[ @brettcannon ] ( https://github.com/brettcannon ) ,一个python的核心开发者,决定在14年的义务劳动之后[ 休一个月的假] ( http://www.snarky.ca/why-i-took-october-off-from-oss-volunteering )
262
257
263
258
就像其他工作一样,有规律的休息会让你对工作保持舒适愉快的心情。
@@ -276,6 +271,6 @@ fork一个项目不什么坏事情。能复制并且修改别人的代码是开
276
271
277
272
休假不仅适用于度假。如果你周末不想做开源项目的工作了,或者在本该工作的时候不想干活了,和别人说,这样他们知道什么时候不该打扰你。
278
273
279
- ## 首先照顾好自己!
274
+ ## It's okay to hit pause
280
275
281
276
维护一个大型项目时,相比早期的增长阶段,是需要更多的不一样的技能,作为一个维护者,你会将自己的领导力和个人能力提高一个层次,而这是很少人能体会的到的。但是与此同时,要挑战管理项目,以及设定清晰的界限。只做你感到舒服的事情,能够让你保持开心,活力,高产的状态。
0 commit comments