Skip to content

Commit 4a1d8cf

Browse files
committed
fix test error
1 parent cd0b893 commit 4a1d8cf

File tree

11 files changed

+60
-93
lines changed

11 files changed

+60
-93
lines changed

Gemfile.lock

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ GEM
2828
execjs (2.7.0)
2929
faraday (0.15.4)
3030
multipart-post (>= 1.2, < 3)
31-
ffi (1.11.0)
31+
ffi (1.11.1)
3232
forwardable-extended (2.6.0)
3333
gemoji (3.0.1)
3434
github-pages (198)

_articles/zh-tw/best-practices.md

Lines changed: 10 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -10,13 +10,13 @@ related:
1010
- leadership
1111
---
1212

13-
## 身爲一名維護者意味著什麼
13+
## 身爲一名維護者意味著什麼?
1414

1515
如果你維護著一個非常流行的專案,你可能就會意識到自己寫程式的時間變少,而花費在回答issue的時間越來越多。
1616

1717
在專案的起步階段,你會不斷嘗試著實現自己的新想法,也能夠基於自己想要的作出決定。隨著專案越來越受歡迎,就會發現你大部分的時間都花在了與用戶、貢獻者打交道上。
1818

19-
維護一個專案需要的不僅僅是寫程式的能力。有些時候會有一個你意想不到的的事情要應付,但是這對一個專案的成長也很重要相對於寫程式來說,我們收集了一些小技巧來讓你的維護工作變得稍輕鬆些,這些技巧,涉及範圍頗廣,從寫文件到管理社群都有所涉獵。
19+
維護一個專案需要的不僅僅是寫程式的能力。有些時候會有一個你意想不到的的事情要應付,但是這對一個專案的成長也很重要(相對於寫程式來說),我們收集了一些小技巧來讓你的維護工作變得稍輕鬆些,這些技巧,涉及範圍頗廣,從寫文件到管理社群都有所涉獵。
2020

2121
## 將流程文件化
2222

@@ -38,7 +38,7 @@ related:
3838

3939
<aside markdown="1" class="pquote">
4040
<img src="https://avatars.githubusercontent.com/lord?s=180" class="pquote-avatar" alt="avatar">
41-
我一直都在摸索。我沒有努力尋求一個完整的解決方案。與其採用那種半吊子辦法,我真希望曾經對某些Issue的提出者說:我暫時沒有時間幹這個,但是我會把他放到我的待辦事項中
41+
我一直都在摸索。我沒有努力尋求一個完整的解決方案。與其採用那種半吊子辦法,我真希望曾經對某些Issue的提出者說:"我暫時沒有時間幹這個,但是我會把他放到我的待辦事項中"
4242
<p markdown="1" class="pquote-credit">
4343
@lord, ["開源專案維護者新手的幾點技巧"](https://lord.io/blog/2014/oss-tips/)
4444
</p>
@@ -77,7 +77,7 @@ related:
7777

7878
把所有的事情都寫下來,當然,對你執行你制定的規則的時候客觀分析實際情況也有幫助。
7979

80-
拒絕別人確實不是很好玩,但是也要表現出專業程度,比如使用你的貢獻不符合這個專案的標準而不是我不喜歡你的貢獻這樣顯得粗魯的語句。
80+
拒絕別人確實不是很好玩,但是也要表現出專業程度,比如使用"你的貢獻不符合這個專案的標準"而不是"我不喜歡你的貢獻"這樣顯得粗魯的語句。
8181

8282
作爲一個維護者,在很多情況下,你都要拒絕別人:不符合專案規則的PR, 某個人脫離了討論的重點,給別人做無關緊要的工作等等。
8383

@@ -119,7 +119,7 @@ related:
119119

120120
> 我和很多來自諸如Mesos, Kubernetes, Chromium等不同開源專案的維護者交流過,他們都異口同聲的覺得做一個維護者最難的就是拒絕你不想要的補丁。
121121
122-
對於不想接受別人的貢獻這件事不要感到愧疚。如 [@shykes](https://github.com/shykes)[所說](https://twitter.com/solomonstre/status/715277134978113536)開源的第一原則就是 _"拒絕是暫時的,接受是永遠的。_ 當然啦,認同別人的熱情還是一件好事,拒絕他的貢獻和拒絕他這個人是兩碼事。(要做到對事不對人。)
122+
對於不想接受別人的貢獻這件事不要感到愧疚。如 [@shykes](https://github.com/shykes)[所說](https://twitter.com/solomonstre/status/715277134978113536)開源的第一原則就是 _"拒絕是暫時的,接受是永遠的。"_ 當然啦,認同別人的熱情還是一件好事,拒絕他的貢獻和拒絕他這個人是兩碼事。(要做到對事不對人。)
123123

124124
最後,如果一個貢獻不是夠好,你沒任何義務接受它。對那些想對你的專案做貢獻的人保持和藹和積極的態度,但是只能接受那些你確定會讓你的專案變得更好的提交。你說拒絕的次數越多,對你來說拒絕別人就越容易。謹記!
125125

@@ -150,7 +150,7 @@ related:
150150

151151
可能在你的社群裡有人不斷提交一些不符合專案需求的貢獻。對你們雙方來說,不停的拒絕他的提交,會令雙方都很尷尬。
152152

153-
如果你發現有人對你的專案很上心,但是就是需要調教,那就耐心一點。給他解釋明白每次它的提交爲什麼不符合專案需求。嘗試著讓他先做一些簡單一點的事,比如那些標有_"good first bug"_ 標籤的issue,以此讓他慢慢習慣。如果你有時間的話,考慮教他/她怎麼完成第一次貢獻,或者在社群找一個人教他/她
153+
如果你發現有人對你的專案很上心,但是就是需要調教,那就耐心一點。給他解釋明白每次它的提交爲什麼不符合專案需求。嘗試著讓他先做一些簡單一點的事,比如那些標有 _"good first issue"_ 标签的issue,以此让他慢慢习惯。如果你有时间的话,考虑教Ta怎么完成第一次贡献,或者在社区找一个人教Ta
154154

155155
## 有效利用社群
156156

@@ -162,20 +162,19 @@ related:
162162

163163
當你看到新的貢獻者不停的提交貢獻,通過分配給他們更多任務來表示認可。如果別人願意的話,記錄下別人是怎麼成長爲領導者的過程。
164164

165-
166165
鼓勵別人來[一起管理專案](../building-community/#share-ownership-of-your-project)能很大程度上減輕你的工作量,就像 [@lmccart](https://github.com/lmccart) 在他的專案上做的那樣,[p5.js](https://github.com/processing/p5.js)
167166

168167
<aside markdown="1" class="pquote">
169168
<img src="https://avatars.githubusercontent.com/lmccart?s=180" class="pquote-avatar" alt="avatar">
170-
我曾經說過,對,每個人都可以參與進來,你不需要有很多編程的經驗。當有申請來參加我們的活動的時候,我就在想,這是真的嗎,我說了啥?有將近40個人來了,我雖然不可能和每個人都單獨交談,但是大家一起來了,這說明我說的沒錯。只要有人知道怎麼做了,他們就能教他們的鄰居。
169+
我曾經說過,"對,每個人都可以參與進來,你不需要有很多編程的經驗。"當有申請來參加我們的活動的時候,我就在想,這是真的嗎,我說了啥?有將近40個人來了,我雖然不可能和每個人都單獨交談,但是大家一起來了,這說明我說的沒錯。只要有人知道怎麼做了,他們就能教他們的鄰居。
171170
<p markdown="1" class="pquote-credit">
172-
@lmccart, ["“開源” 意味著什麼? p5.js 版](https://medium.com/@kenjagan/what-does-open-source-even-mean-p5-js-edition-98c02d354b39)
171+
@lmccart, ["開源" 意味著什麼? p5.js 版](https://medium.com/@kenjagan/what-does-open-source-even-mean-p5-js-edition-98c02d354b39)
173172
</p>
174173
</aside>
175174

176175
如果你需要暫時或者永久的離開的專案,請找人來代替你,這並沒有什麼不好意思。
177176

178-
如果別人認同專案的發展方向,給他們提交的權限或者正式把專案所有權轉移給他。如果有人fork了你的專案而且在保持活躍的維護中,考慮在你的原始的倉庫放上這個fork版本的鏈接。如果大家都希望你的專案繼續的話這不失爲一種好辦法
177+
如果別人認同專案的發展方向,給他們提交的權限或者正式把專案所有權轉移給他。如果有人fork了你的專案而且在保持活躍的維護中,考慮在你的原始的倉庫放上這個fork版本的鏈接。如果大家都希望你的專案繼續的話這不失爲一種好辦法
179178

180179
[@progruim](https://github.com/progrium) [發現](https://progrium.com/blog/2015/12/04/leadership-guilt-and-pull-requests/) 由於它給他的專案[Dokku](https://github.com/dokku/dokku)寫一個關於專案發展方向的文件,即使在它離開這個專案後他的那些目標仍然會被實現。
181180

@@ -247,7 +246,7 @@ fork一個專案不什麼壞事情。能複製並且修改別人的程式是開
247246

248247
疲倦在開源工作工作中是一個常見的問題,特別是在維護者中間。作爲一個維護者,你做的開心對專案的生存來說是一個沒有商量餘地的條件。
249248

250-
雖然你不需要跟誰請假,但是也不要拖到自己疲倦不堪的時候纔去度假。[@brettcannon](https://github.com/brettcannon),一個python的核心開發者,決定在14年的義務勞動之後[休一個月的假](http://www.snarky.ca/why-i-took-october-off-from-oss-volunteering)
249+
雖然你不需要跟誰請假,但是也不要拖到自己疲倦不堪的時候纔去度假。[@brettcannon](https://github.com/brettcannon),一個python的核心開發者,決定在14年的義務勞動之後[休一个月的假](http://www.snarky.ca/why-i-took-october-off-from-oss-volunteering)
251250

252251
就像其他工作一樣,有規律的休息會讓你對工作保持舒適愉快的心情。
253252

_articles/zh-tw/building-community.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -171,7 +171,6 @@ related:
171171

172172
事實上很多專案[只有一個或者兩個維護者](https://peerj.com/preprints/1233.pdf)去做大部分的工作。隨著社群變得越來越大,就會有更多的人參與進來。
173173

174-
175174
雖然並不是一直都有人在回答問題,但是你可以去試著增加一些機會,讓他人有能夠參與的機會,越是儘早開始,越是能夠獲得幫助。
176175

177176
<aside markdown="1" class="pquote">

_articles/zh-tw/code-of-conduct.md

Lines changed: 2 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -16,8 +16,7 @@ related:
1616

1717
行爲守則不僅幫助保護你們的參與者,同時還有你們自己。如果你們維護一個專案,隨着時間的推移,可能會發現其他參與者懶散的態度會讓你們疲憊或對工作不滿意。
1818

19-
一份行爲守則可以幫助你們促進健康,有建設性的社群行爲。積極主動減少你們或其他人在你們的專案中變得疲勞的可能性,並幫助你們在有人做出你們不同意的事情時採取行動。
20-
19+
一份行爲守則可以幫助你們促進健康,有建設性的社群行爲。積極主動減少你們或其他人在你們的專案中變得疲勞的可能性,並幫助你們在有人做出你們不同意的事情時採取行動。
2120

2221
## 建立行爲守則
2322

@@ -32,7 +31,6 @@ related:
3231

3332
無論你們在哪裏,請使用已有的行爲守則。[貢獻者盟約](http://contributor-covenant.org/)是一個被超過40,000個開源專案(包括Kubernetes, Rails和Swift)所使用的行爲守則。
3433

35-
3634
[Django行爲守則](https://www.djangoproject.com/conduct/)[Citizen行爲守則](http://citizencodeofconduct.org/)都是非常好的行爲守則。
3735

3836
請將CODE_OF_CONDUCT文件放在你們專案的根目錄,並在README中附上其鏈接,這樣對你們的社群是可見的。
@@ -60,7 +58,6 @@ related:
6058

6159
> 對於濫用現象,擾亂或者其他不可接受的行爲都可以向**[email protected]**(僅由C. Titus Brown和Michael R. Crusoe處理)發送郵件。要報告涉及其中任何一個的問題,請電郵**Judi Brown Clarke,Ph.D.** BEACON行動進化研究中心的多元化主任,NSF科學技術中心。
6260
63-
6461
爲了獲得靈感,可以查閱Django的[執行手冊](https://www.djangoproject.com/conduct/enforcement-manual/)(你們是否需要如此詳細的手冊,這取決於你們的專案)。
6562

6663
## 執行你們的行爲守則
@@ -71,7 +68,6 @@ related:
7168

7269
認真對待社群中每個成員的想法。如果你們收到有人違規的報告,請認真對待並調查此事,即使它不符合你們自己的經驗。這樣做可以向你們的社群表面,你們珍視他們的觀點和信任他們的判斷。
7370

74-
7571
有的社群成員可能是讓大家一直不舒服的慣犯,或者他們只是說了或做了一次。這都需要依據實際情況進行處理。
7672

7773
在你們做出迴應之前,請認真思考發生了什麼事。通過閱讀他們過去的評論和對話可以更好地理解他們爲什麼要那樣做。儘量收集其他人對他們行爲的看法。
@@ -87,7 +83,6 @@ related:
8783

8884
當蒐集和處理足夠的資訊後,你們需要決定做什麼。當你們在考慮下一步的時候,請牢記你們的目的是營造一個安全,尊重和協作的社群氛圍。不僅要考慮如何處理有問題的情況,還要考慮們的反應將如何影響你們社群的其他行爲和期望。
8985

90-
9186
當有人報告違規時,處理它是你們的工作,而不是他們的。有時,報告者透露他們的資訊會給他們的職業生涯,聲譽和人生安全帶來很大的風險。迫使報告者面對騷擾者會將他們置於妥協的位置。除非報告者有特別的要求,你們應該直接和有問題的人溝通。
9287

9388
這裏有些方法幫助你們迴應違規行爲:
@@ -102,14 +97,12 @@ related:
10297

10398
* **永久禁止**有關人員加入專案
10499

105-
對于禁止成員的做法,你們應該非常謹慎,只有在沒有其他解決方案的情況下才能使用。
106-
100+
對于禁止成員的做法,你們應該非常謹慎,只有在沒有其他解決方案的情況下才能使用。
107101

108102
## 維護者的責任和義務
109103

110104
行爲守則不是可以任意執行的法律。你們是行爲守則的執行者,同時你們的責任是遵守行爲守則確立的規矩。
111105

112-
113106
作爲維護者,你們可以爲社群指定準則,同時你們可以根據行爲守則執行這些準則。這意味着你們需要認真處理違規行爲。報告者對他們的投訴進行了徹底和認真地審查。如果你們確定他們報告的行爲沒有違規,你們需要他們進行溝通並解釋你們爲什麼不進行處理。他們會怎樣做,取決於他們:容忍他們認爲有問題的行爲,或者停止參與社群。
114107

115108
如果報告的行爲沒有_技術上_的違規,這可能表面你們的社群依然存在問題,同時你們應該調查潛在的問題以及採取相應的行動。這可能包括修改你們的行爲守則,以澄清可接受的行爲和/或與行爲被舉報的人交談,並告訴他們,雖然他們沒有違反行爲守則,但是他們在期望和確定的邊緣另其他參與者感到不舒服。
@@ -119,4 +112,3 @@ related:
119112
## 鼓勵你們希望看見的行爲 🌎
120113

121114
當你們的社群變得似乎敵對或者不受歡迎時,即使是一個大家能容忍的個人行爲,也會讓你們失去很多貢獻者,你們可能再也遇不到其中的一些人。雖然執行或者採用行爲守則很難,但是營造一個受歡迎的環境將幫助你們社群成長。
122-

0 commit comments

Comments
 (0)