Skip to content

Commit

Permalink
Merge branch 'master' into patch-1
Browse files Browse the repository at this point in the history
  • Loading branch information
WilliamAboucaya authored Jun 28, 2019
2 parents 4df44da + 8f1d09a commit 492ba81
Show file tree
Hide file tree
Showing 23 changed files with 2,446 additions and 80 deletions.
10 changes: 5 additions & 5 deletions Gemfile.lock
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,6 @@ GEM
execjs
coffee-script-source (1.11.1)
colorator (1.1.0)
colorize (0.8.1)
commonmarker (0.17.13)
ruby-enum (~> 0.5)
concurrent-ruby (1.1.5)
Expand Down Expand Up @@ -85,13 +84,13 @@ GEM
html-pipeline (2.11.0)
activesupport (>= 2)
nokogiri (>= 1.4)
html-proofer (3.10.2)
html-proofer (3.11.0)
activesupport (>= 4.2, < 6.0)
addressable (~> 2.3)
colorize (~> 0.8)
mercenary (~> 0.3.2)
nokogiri (~> 1.9)
parallel (~> 1.3)
rainbow (~> 3.0)
typhoeus (~> 1.3)
yell (~> 2.0)
http_parser.rb (0.6.0)
Expand Down Expand Up @@ -222,7 +221,8 @@ GEM
parallel (1.17.0)
pathutil (0.16.2)
forwardable-extended (~> 2.6)
public_suffix (3.0.3)
public_suffix (3.1.0)
rainbow (3.0.0)
rake (12.3.2)
rb-fsevent (0.10.3)
rb-inotify (0.10.0)
Expand All @@ -231,7 +231,7 @@ GEM
ruby-enum (0.7.2)
i18n
ruby_dep (1.5.0)
rubyzip (1.2.2)
rubyzip (1.2.3)
safe_yaml (1.0.5)
sass (3.7.4)
sass-listen (~> 4.0.0)
Expand Down
4 changes: 2 additions & 2 deletions _articles/id/starting-a-project.md
Original file line number Diff line number Diff line change
Expand Up @@ -324,7 +324,7 @@ Jika Anda perseorangan:
<div class="clearfix mb-4">
<input type="checkbox" id="cbox8" class="d-block float-left mt-1 mr-2" value="checkbox">
<label for="cbox8" class="overflow-hidden d-block text-normal">
Anda telah mengunjungi kantor hukum dan/atau membahami hak cipta dan kebijakan open source pada perusahaan Anda (jika Anda merupakan karyawan pada sebuah perusahaan)
Anda telah mengunjungi kantor hukum dan/atau memahami hak cipta dan kebijakan open source pada perusahaan Anda (jika Anda merupakan karyawan pada sebuah perusahaan)
</label>
</div>

Expand Down Expand Up @@ -354,7 +354,7 @@ Jika Anda merupakan perusahaan atau organisasi:
<div class="clearfix mb-4">
<input type="checkbox" id="cbox12" class="d-block float-left mt-1 mr-2" value="checkbox">
<label for="cbox12" class="overflow-hidden d-block text-normal">
Minimal terdapat dua orang yang memiliki akses admministratif pada proyek
Minimal terdapat dua orang yang memiliki akses administratif pada proyek
</label>
</div>

Expand Down
9 changes: 9 additions & 0 deletions _articles/leadership-and-governance.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,15 @@ lang: en
title: Leadership and Governance
description: Growing open source projects can benefit from formal rules for making decisions.
class: leadership
toc:
understanding-governance-for-your-growing-project: "Understanding governance for your growing project"
what-are-examples-of-formal-roles-used-in-open-source-projects: "What are examples of formal roles used in open source projects?"
how-do-i-formalize-these-leadership-roles: "How do I formalize these leadership roles?"
when-should-i-give-someone-commit-access: "When should I give someone commit access?"
what-are-some-of-the-common-governance-structures-for-open-source-projects: "What are some of the common governance structures for open source projects?"
do-i-need-governance-docs-when-i-launch-my-project: "Do I need governance docs when I launch my project?"
what-happens-if-corporate-employees-start-submitting-contributions: "What happens if corporate employees start submitting contributions?"
do-i-need-a-legal-entity-to-support-my-project: "Do I need a legal entity to support my project?"
order: 6
image: /assets/images/cards/leadership.png
related:
Expand Down
6 changes: 3 additions & 3 deletions _articles/zh-cn/best-practices.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ related:

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

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

## Documenting your processes

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

[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) 均是为维护者和贡献者提供了很好的基本规则的项目.乃业内典范。

Expand Down Expand Up @@ -101,7 +101,7 @@ related:

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

更好的方式是马上关掉你不想接受的贡献。如果你的项目已经保守积压的issue的折磨@steveklabnik 可以给你点儿建议,[如何高效的解决issue](https://words.steveklabnik.com/how-to-be-an-open-source-gardener)
更好的方式是马上关掉你不想接受的贡献。 如果你的项目已经积压大量的问题@steveklabnik 可以给你点儿建议,[如何高效的解决issue](https://words.steveklabnik.com/how-to-be-an-open-source-gardener)

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

Expand Down
10 changes: 5 additions & 5 deletions _articles/zh-cn/building-community.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,12 +26,12 @@ related:

从你的文档开始:

* **让大家很容易上手。** [一份友好的 README](https://github.com/liadbiz/opensource-contribute-guide-chinise/blob/master/github-open-source-guide-02.md#编写readme)以及清晰的代码示例将让大家很容易的上手。
* **清楚的解释如何做贡献**,使用[你的CONTRIBUTING file](https://github.com/liadbiz/opensource-contribute-guide-chinise/blob/master/github-open-source-guide-02.md#编写你的贡献指南)以及持续更新issues。
* **让大家很容易上手。** [一份友好的 README](../starting-a-project/#writing-a-readme)以及清晰的代码示例将让大家很容易的上手。
* **清楚的解释如何做贡献**,使用[你的CONTRIBUTING file](../starting-a-project/#writing-your-contributing-guidelines)以及持续更新issues。

好的文档能够邀请他人参与你们项目的互动。最终,一些人会开一个issue或者pull request。将这些互动视为机会,将他们转移到漏斗的下方。

* **当一些人选择了你们的项目,请对他们表示感谢!** 仅仅只是一次消极的经历就足以让一些人再也不想回来
* **当一些人选择了你们的项目,请对他们表示感谢!** 一次糟糕的体验就可能失去一个用户
* **及时回应。** 如果你们一个月都没有回答他们的问题,他们可能早已忘记了你们的项目。
* **对你以后接受的所有贡献者持开放态度。** 很多贡献者是从一份bug报告或者小的修复开始的。这里有[很多为项目做贡献的方式](../how-to-contribute/#what-it-means-to-contribute)。让大家选择他们喜欢的方式。
* **如果你不赞成一个贡献,** 首先你需要对他们的想法表示感谢,同时 [解释为什么](../best-practices/#learning-to-say-no)它不适合项目,如果有必要的话你可以给出相关的文档链接。
Expand Down Expand Up @@ -116,14 +116,14 @@ related:
<aside markdown="1" class="pquote">
<img src="https://avatars.githubusercontent.com/karissa?s=180" class="pquote-avatar" alt="avatar">

事实上是,拥有一个支持性社区才是项目成功的关键。如果没有来自我的同事,互联网上一些友好的陌生人,以及聊天渠道IRC的帮助,我不可能做好这些工作。(。。。)不要退而求其次。不要满足于混蛋
事实上是,拥有一个支持性社区才是项目成功的关键。如果没有来自我的同事,互联网上一些友好的陌生人,以及聊天渠道IRC的帮助,我不可能做好这些工作。(。。。)不要退而求其次。不要容忍混蛋

<p markdown="1" class="pquote-credit">
@karissa, ["如何运营一个 FOSS 项目"](https://okdistribute.xyz/post/okf-de)
</p>
</aside>

对项目的微不足道的问题进行定期辩论会分散别人的注意力,包括你自己,要将精力几种在重要的任务上,新人如果看见这样的情景,他们可能不会加入到项目中来
关于项目琐碎方面的定期辩论会分散其他人(包括您)的注意力,使他们无法专注于重要任务。新人可能会看到这些对话而不想参加

当发现社区中有消极的行为时,要即时、公然的指出来。特别说明的是,要用坚定的语气解释他们的行为为什么是不可接受的。如果这种问题继续发生,你有必要[要求他们离开](../code-of-conduct/#enforcing-your-code-of-conduct)。你的[行为准则](../code-of-conduct/)是为这些情景准备的建设性指南。

Expand Down
2 changes: 1 addition & 1 deletion _articles/zh-cn/getting-paid.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ related:

<aside markdown="1" class="pquote">
<img src="https://avatars.githubusercontent.com/ashedryden?s=180" class="pquote-avatar" alt="avatar">
询问任何一位开源项目的维护著,他们都会告诉你关于管理一个项目需要花费大量时间的真相。你拥有客户,你的为他们修复问题,你创建新的功能。这些都需要真正的花时间去做的事情
询问任何一位开源项目维护者,他们会告诉您管理项目的工作量的实际情况。你拥有客户,你要为他们解决问题,你要创建新功能,这些都需要花时间去做
<p markdown="1" class="pquote-credit">
@ashedryden, ["无偿劳动的伦理和开源软件社区"](https://www.ashedryden.com/blog/the-ethics-of-unpaid-labor-and-the-oss-community)
</p>
Expand Down
Loading

0 comments on commit 492ba81

Please sign in to comment.