diff --git a/Gemfile.lock b/Gemfile.lock index ac10b70a90d..911f4374a79 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -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) @@ -86,13 +85,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) @@ -224,6 +223,7 @@ GEM pathutil (0.16.2) forwardable-extended (~> 2.6) public_suffix (3.1.0) + rainbow (3.0.0) rake (12.3.2) rb-fsevent (0.10.3) rb-inotify (0.10.0) diff --git a/_articles/id/starting-a-project.md b/_articles/id/starting-a-project.md index 5d08f14f5a2..f1c276d7109 100644 --- a/_articles/id/starting-a-project.md +++ b/_articles/id/starting-a-project.md @@ -324,7 +324,7 @@ Jika Anda perseorangan:
@@ -354,7 +354,7 @@ Jika Anda merupakan perusahaan atau organisasi:
diff --git a/_articles/leadership-and-governance.md b/_articles/leadership-and-governance.md index b0981efb31a..ab4c7977007 100644 --- a/_articles/leadership-and-governance.md +++ b/_articles/leadership-and-governance.md @@ -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: diff --git a/_articles/zh-cn/best-practices.md b/_articles/zh-cn/best-practices.md index 150585ebfe6..4dbefe18356 100644 --- a/_articles/zh-cn/best-practices.md +++ b/_articles/zh-cn/best-practices.md @@ -16,7 +16,7 @@ related: 在项目的起步阶段,你会不断尝试着实现自己的新想法,也能够基于自己想要的作出决定。随着项目逐渐的开始流行,就会发现你的大部分时间都花在了与用户、贡献者打交道上。 -维护一个项目需要的不仅仅是写代码的能力。有些时候会有一个你意想不到的的事情要应付,但是这对一个项目的成长也很重要(相对于代码来说),我们收集了一些小技巧来让你的维护工作变得稍轻松些,这些技巧,涉及范围颇广,从写文档到管理社区都有所涉猎。 +维护项目需要的不仅仅是编码。有些意料之外的任务,对于项目的持续发展同样重要。我们收集了几种方法让你的维护工作变得稍轻松些,这些技巧,涉及范围颇广,从编写文档到管理社区都有所涉及。 ## Documenting your processes @@ -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) 均是为维护者和贡献者提供了很好的基本规则的项目.乃业内典范。 @@ -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)。 第二点,忽略别人的贡献等于是在社区传递了一个负面的信号。让人感觉提交一个贡献是蛮恐惧的事情,尤其是对于刚加入的新手来说。即使你不接受他们的贡献,告诉他们为什么然后致谢。这会让人觉得更舒服。 diff --git a/_articles/zh-cn/building-community.md b/_articles/zh-cn/building-community.md index a77d36f3a88..8661202861a 100644 --- a/_articles/zh-cn/building-community.md +++ b/_articles/zh-cn/building-community.md @@ -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)它不适合项目,如果有必要的话你可以给出相关的文档链接。 @@ -116,14 +116,14 @@ related: -对项目的微不足道的问题进行定期辩论会分散别人的注意力,包括你自己,要将精力几种在重要的任务上,新人如果看见这样的情景,他们可能不会加入到项目中来。 +关于项目琐碎方面的定期辩论会分散其他人(包括您)的注意力,使他们无法专注于重要任务。新人可能会看到这些对话而不想参加。 当发现社区中有消极的行为时,要即时、公然的指出来。特别说明的是,要用坚定的语气解释他们的行为为什么是不可接受的。如果这种问题继续发生,你有必要[要求他们离开](../code-of-conduct/#enforcing-your-code-of-conduct)。你的[行为准则](../code-of-conduct/)是为这些情景准备的建设性指南。 diff --git a/_articles/zh-cn/getting-paid.md b/_articles/zh-cn/getting-paid.md index aa4bd5efca5..252269e719c 100644 --- a/_articles/zh-cn/getting-paid.md +++ b/_articles/zh-cn/getting-paid.md @@ -42,7 +42,7 @@ related: