Merge branch 'master' of https://github.com/github/opensource.guide

merging upstream into master

Author: Alexander Muzenhardt

_articles/zh-cn/best-practices.md

@@ -10,15 +10,15 @@ related:
   - leadership
 ---
 
-## What does it mean to be a maintainer?
+## 身为维护者意味这什么？
 
 如果你维护着一个非常流行的项目，你可能就会意识到自己写代码的时间变少，而花费在回答issue的时间越来越多。
 
 在项目的起步阶段，你会不断尝试着实现自己的新想法，也能够基于自己想要的作出决定。随着项目逐渐的开始流行，就会发现你的大部分时间都花在了与用户、贡献者打交道上。
 
 维护项目需要的不仅仅是编码。有些意料之外的任务，对于项目的持续发展同样重要。我们收集了几种方法让你的维护工作变得稍轻松些，这些技巧，涉及范围颇广，从编写文档到管理社区都有所涉及。
 
-## Documenting your processes
+## 流程文档化
 
 对于一个项目的维护者来说写文档是最重要的事情之一。
 
@@ -73,7 +73,7 @@ related:
 
 这样的话，每个人新加入到你们社区的人和已经呆了多年的人能够了解到的信息是一样的。
 
-## Learning to say no
+## 学会说不
 
 把所有的事情都写下来，当然，对你执行你制定的规则的时候客观分析实际情况也有帮助。
 
@@ -152,7 +152,7 @@ related:
 
 如果你发现有人对你的项目很上心，但是就是需要调教，那就耐心一点。给他解释明白每次它的提交为什么不符合项目需求。尝试着让他先做一些简单一点的事，比如那些标有 _"good first issue"_ 标签的issue，以此让他慢慢习惯。如果你有时间的话，考虑教Ta怎么完成第一次贡献，或者在社区找一个人教Ta。
 
-## Leverage your community
+## 依托你的社区
 
 你不需要凡事亲力亲为。这就是社区存在的原因！即使你没有一个活跃的贡献者社区，但是如果你有很多用户的话，拉他们来干活儿。
 
@@ -162,7 +162,7 @@ related:
 
 当你看到新的贡献者不停的提交贡献，通过分配给他们更多任务来表示认可。如果别人愿意的话，记录下别人是怎么成长为领导者的过程。
 
-鼓励别人来[一起管理项目](../building-community/#share-ownership-of-your-project)能很大程度上减轻你的工作量，就像 [@lmccart](https://github.com/lmccart) 在他的项目上做的那样，[p5.js](https://github.com/processing/p5.js)
+鼓励别人来[一起管理项目](../building-community/#共享项目所有权)能很大程度上减轻你的工作量，就像 [@lmccart](https://github.com/lmccart) 在他的项目上做的那样，[p5.js](https://github.com/processing/p5.js)
 
 <aside markdown="1" class="pquote">
   <img src="https://avatars.githubusercontent.com/lmccart?s=180" class="pquote-avatar" alt="avatar">
@@ -198,7 +198,7 @@ fork一个项目不什么坏事情。能复制并且修改别人的代码是开
 
 > 一旦一个项目变大之后，维护者对怎么增加新代码变得保守是不可避免的事情。你可能很会拒绝别人的需求，但是很多人提的都是合法的需求。所以，你不得不把你的一个工具变成平台。
 
-## Bring in the robots
+## 使用机器人
 
 就像很多工作别人可以帮你做一样，也有很多工作不需要人来做。因为有机器可以替代人工，尤其是那些重复、无聊的工作，用好它们能够让你的维护生活变得更容易。
 
@@ -264,6 +264,6 @@ fork一个项目不什么坏事情。能复制并且修改别人的代码是开
 
 休假不仅适用于度假。如果你周末不想做开源项目的工作了，或者在本该工作的时候不想干活了，和别人说，这样他们知道什么时候不该打扰你。
 
-## It's okay to hit pause
+## 完事不必亲力亲为
 
 维护一个大型项目时，相比早期的增长阶段，是需要更多的不一样的技能，作为一个维护者，你会将自己的领导力和个人能力提高一个层次，而这是很少人能体会的到的。但是与此同时，要挑战管理项目，以及设定清晰的界限。只做你感到舒服的事情，能够让你保持开心，活力，高产的状态。

_articles/zh-cn/building-community.md

@@ -10,7 +10,7 @@ related:
   - coc
 ---
 
-## Setting your project up for success
+## 让项目向成功方向迈进
 
 现在的你，已经启动了属于自己的项目，而且正在传播它，更重要的是现在已经有人将之下载到本地进行观摩。这真是令人振奋！那么你现在要做的就是，怎么能够让这些有兴趣的人们坚持下去，持续跟进项目。
 
@@ -26,15 +26,15 @@ related:
 
 从你的文档开始：
 
-* **让大家很容易上手。** [一份友好的 README](../starting-a-project/#writing-a-readme)以及清晰的代码示例将让大家很容易的上手。
-* **清楚的解释如何做贡献**，使用[你的CONTRIBUTING file](../starting-a-project/#writing-your-contributing-guidelines)以及持续更新issues。
+* **让大家很容易上手。** [一份友好的 README](../starting-a-project/#撰写自述文件)以及清晰的代码示例将让大家很容易的上手。
+* **清楚的解释如何做贡献**，使用[你的CONTRIBUTING file](../starting-a-project/#编写你的贡献指南)以及持续更新issues。
 
 好的文档能够邀请他人参与你们项目的互动。最终，一些人会开一个issue或者pull request。将这些互动视为机会，将他们转移到漏斗的下方。
 
 * **当一些人选择了你们的项目，请对他们表示感谢！** 一次糟糕的体验就可能失去一个用户。
 * **及时回应。** 如果你们一个月都没有回答他们的问题，他们可能早已忘记了你们的项目。
-* **对你以后接受的所有贡献者持开放态度。** 很多贡献者是从一份bug报告或者小的修复开始的。这里有[很多为项目做贡献的方式](../how-to-contribute/#what-it-means-to-contribute)。让大家选择他们喜欢的方式。
-* **如果你不赞成一个贡献，** 首先你需要对他们的想法表示感谢，同时 [解释为什么](../best-practices/#learning-to-say-no)它不适合项目，如果有必要的话你可以给出相关的文档链接。
+* **对你以后接受的所有贡献者持开放态度。** 很多贡献者是从一份bug报告或者小的修复开始的。这里有[很多为项目做贡献的方式](../how-to-contribute/#贡献意味着什么)。让大家选择他们喜欢的方式。
+* **如果你不赞成一个贡献，** 首先你需要对他们的想法表示感谢，同时 [解释为什么](../best-practices/#学会说不)它不适合项目，如果有必要的话你可以给出相关的文档链接。
 
 <aside markdown="1" class="pquote">
   <img src="https://avatars.githubusercontent.com/mikeal?s=180" class="pquote-avatar" alt="avatar">
@@ -103,11 +103,11 @@ related:
 
 公开交流需要特别注意的事项：1）有关安全方面的issues 2）敏感的行为准则。应该为大家提供一个私下报告这些issue的方式。若不想使用自己的个人邮箱，那么就创建一个公用的邮箱。
 
-## Growing your community
+## 发展你们的社区
 
 社区拥有强大的能量。这种能量可能是正面的也可能是负面的，这一切都取决于你如何驾驭它。随着项目社区的成长，要想办法让之成为建设性的力量，而不是具有破坏性的。
 
-### Don't tolerate bad actors
+### 不纵容坏人
 
 一些流行的项目将不可避免地会吸引到一些破坏它们的人。这些人可能会从一些没必要的争论开始，对一些细枝末节进行纠缠不清，甚或用语言伤及他人。
 
@@ -125,7 +125,7 @@ related:
 
 关于项目琐碎方面的定期辩论会分散其他人（包括您）的注意力，使他们无法专注于重要任务。新人可能会看到这些对话而不想参加。
 
-当发现社区中有消极的行为时，要即时、公然的指出来。特别说明的是，要用坚定的语气解释他们的行为为什么是不可接受的。如果这种问题继续发生，你有必要[要求他们离开](../code-of-conduct/#enforcing-your-code-of-conduct)。你的[行为准则](../code-of-conduct/)是为这些情景准备的建设性指南。
+当发现社区中有消极的行为时，要即时、公然的指出来。特别说明的是，要用坚定的语气解释他们的行为为什么是不可接受的。如果这种问题继续发生，你有必要[要求他们离开](../code-of-conduct/#执行你们的行为守则)。你的[行为准则](../code-of-conduct/)是为这些情景准备的建设性指南。
 
 ### 知道贡献者在哪里
 
@@ -145,7 +145,7 @@ related:
 
 > 我们想感谢你们使用Rubinius。这个项目是一个充满爱的工作，我们希望所有用户查找bugs，取得性能上的提升，以及帮助完善文档。每一个贡献都是有意义的，所以感谢你们的参与。话虽如此，但我们还是要求你们遵守一些指南，这样我们就能够找到你们的issue。
 
-### Share ownership of your project
+### 共享项目所有权
 
 <aside markdown="1" class="pquote">
   <img src="https://avatars.githubusercontent.com/sagesharp?s=180" class="pquote-avatar" alt="avatar">
@@ -183,7 +183,7 @@ related:
   </p>
 </aside>
 
-## Resolving conflicts
+## 解决冲突
 
 在项目的早期，做决定是件蛮容易的事。几乎是想做什么就可以做什么。
 
@@ -212,7 +212,7 @@ related:
 
 ### 将你们的README视为最高法则
 
-README [不仅仅是一组指令](../starting-a-project/#writing-a-readme)。它也是一个谈论目标、产品愿景和路线的地方。
+README [不仅仅是一组指令](../starting-a-project/#撰写自述文件)。它也是一个谈论目标、产品愿景和路线的地方。
 如果人们过分专注于讨论特定功能的优点，它可能有助于重新审视您的README，并谈论项目的更高的愿景。关注README也会使对话变得个人化，所以可以进行建设性的讨论。
 
 ### 专注过程，而不是结果
@@ -277,6 +277,6 @@ Atom Issues不存在投票系统的部分原因是因为Atom团队在所有情
 
 使用决策者应该是你们最后才能采取的手段。分离issues是一个你们社区成长和学习的机会。利用这些机会并精诚合作，尽量找出问题的解决方案。
 
-## Community is the ❤️ of open source
+## 社区是开源的❤️
 
 健康，蓬勃的社区每周都会为开源付出大量辛勤的劳动。许多贡献者指出其他人在开源工作或不在开源工作的原因。通过学习如何建设性地利用这股力量，你们会帮助他人有一个难忘的开源体验。

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

@@ -10,15 +10,15 @@ related:
   - leadership
 ---
 
-## Why do I need a code of conduct?
+## 为什么我们需要行为守则？
 
 行为守则是一份确立项目参与者行为规范的文件。采用和执行行为守则可以帮助你们的社区营造积极的氛围。
 
 行为守则不仅帮助保护你们的参与者，同时还有你们自己。如果你们维护一个项目，随着时间的推移，可能会发现其他参与者懒散的态度会让你们疲惫或对工作不满意。
 
 一份行为守则可以帮助你们促进健康，有建设性的社区行为。积极主动减少你们或其他人在你们的项目中变得疲劳的可能性，并帮助你们在有人做出你们不同意的事情时采取行动。
 
-## Establishing a code of conduct
+## 建立一个行为守则
 
 尽可能早地建立行为守则，当你们第一次创建项目的时候。
 
@@ -35,7 +35,7 @@ related:
 
 请将CODE_OF_CONDUCT文件放在你们项目的根目录，并在README中附上其链接，这样对你们的社区是可见的。
 
-## Deciding how you'll enforce your code of conduct
+## 决定你们如何执行行为守则
 
 <aside markdown="1" class="pquote">
   一份行为守则没有（或者不能）执行会比没有行为守则更糟糕。它释放这样一个信息：行为守则或者尊重在你们的社区并不重要。
@@ -60,7 +60,7 @@ related:
 
 为了获得灵感，可以查阅Django的[执行手册](https://www.djangoproject.com/conduct/enforcement-manual/)（你们是否需要如此详细的手册，这取决于你们的项目）。
 
-## Enforcing your code of conduct
+## 执行你们的行为守则
 
 有时，尽管你们尽了最大的努力，仍然会有人违反守则。当这样的情况发生时，有几种方法来解决消极或有害的行为。
 

_articles/zh-cn/finding-users.md

@@ -10,11 +10,11 @@ related:
   - building
 ---
 
-## Spreading the word
+## 四处传播
 
 并没有什么规范说当你创建一个开源项目时，要怎么去推广它。但没有任何理由说必须默默无闻的在开源项目上工作。相反，如果你想要有更多的人发现和使用你的开源项目，你就应该让所有人知道你所努力的成果！
 
-## Figure out your message
+## 发出你的声音
 
 在开始推广你的项目之前，你应该能够解释你的项目是做什么的，为什么大家需要它?
 
@@ -28,7 +28,7 @@ related:
 
 如果你想深入了解如何挖掘项目的"卖点"，看一下Mozilla的["Personas and Pathways"](https://mozillascience.github.io/working-open-workshop/personas_pathways/)，练习如何建立用户的形象。
 
-## Help people find and follow your project
+## 帮助用户找到并且追随你的项目
 
 <aside markdown="1" class="pquote">
   你最好有一个唯一的"主页"链接用来推广，引导人们关注你的项目。你不需要找一个炫酷的模板或者域名，但是你的项目确实需要一个入口。

_articles/zh-cn/getting-paid.md

@@ -10,7 +10,7 @@ related:
   - leadership
 ---
 
-## Why some people seek financial support
+## 为何有人需要寻找经济上支持
 
 很多开源的工作都是来自志愿者的辛勤付出。例如，有些人在使用项目的过程中遇到了问题，然后快速的修复了；也有些人是利用他们的业余时间在开源项目中需求挑战。
 
@@ -60,7 +60,7 @@ related:
 
 如果你在寻找金钱上的支持，可以考虑两条路径。你可以作为贡献者来将你的时间作为资金，或者是找一家能够为项目提供资金的组织。
 
-## Funding your own time
+## 为你自己的时间募资
 
 在今天，有很多人在开源中获得了报酬，无论是兼职或全职。最为常见的做法就是，有些老板愿意为你付出的时间和工作成果掏腰包。
 
@@ -104,7 +104,7 @@ related:
 * @gaearon 通过 [Patreon crowdfunding campaign](https://redux.js.org/)为他的项目 [Redux](https://github.com/reactjs/redux)成功的融到了资金。
 * @andrewgodwin [通过 Kickstarter campaign](https://www.kickstarter.com/projects/andrewgodwin/schema-migrations-for-django) 为Django schema 迁移拿到了资金
 
-## Finding funding for your project
+## 为你的项目募资
 
 除了针对个人贡献者的建议之外，还有一些项目可以从公司、独立投资方、以及其它的资金处来获得进一步的工作。
 
@@ -124,7 +124,7 @@ related:
 
 更多的案例和细节， @nayafia [专门写过一个指南](https://github.com/nayafia/lemonade-stand) ，专门针对的就是如何为开源工作获得报酬。不同类型的资助需要不同的技能，所以仔细的掂量下资格，然后找个最适合自己的方式。
 
-## Building a case for financial support
+## 获取商业支持
 
 无论你的项目是新的创意，还是已经运行多年，你都需要为你的资助者满意，并提出有效而合理的案例。
 
@@ -158,6 +158,6 @@ related:
   </p>
 </aside>
 
-## Experiment and don't give up
+## 持续尝试不言放弃
 
 赚更多的钱不是件容易的事情，无论你是在开源项目，亦或是在非盈利组织，又或者是软件的创业公司，但是无论在哪里，挣更多钱的秘密就是更多的创造力。当确定了你想如何获得报酬的时候，请继续你的研究，将自己放在投资人的角度来看问题，可以帮助你更好的构建一个更加令人信服的赚钱之道。

_articles/zh-cn/how-to-contribute.md

@@ -10,7 +10,7 @@ related:
   - building
 ---
 
-## Why contribute to open source?
+## 为什么要为开源做贡献?
 
 <aside markdown="1" class="pquote">
   <img src="https://avatars.githubusercontent.com/errietta?s=180" class="pquote-avatar" alt="avatar">
@@ -48,7 +48,7 @@ related:
 
 在开源的世界里，作出贡献的不一定非得是花了很长时间拥有大量经验的人。你是否遇到过浏览某些网站发现有拼写错误，希望有人能修改它？其实，在开源的项目中，你只需要做就可以了。没有那么多的顾忌，开源让人们在很舒服的状态做事，而这才是这个世界应有的体验。
 
-## What it means to contribute
+## 贡献意味着什么
 
 如果你是一名开源界的新手，可能会对贡献的流程心生畏惧。比如：该如何找到正确的项目？不懂编码又想参与怎么办？万一做错事情了怎么办？
 
@@ -142,7 +142,7 @@ related:
 
 尽管你是一名软件开发者，也可以去撰写一些文档去帮助新的入门者。其实项目中那些看起来令人生畏的项目并不是写代码，做开发者总得挑战自己，其实在做得过程中可以增强信心和获得全新的体验。
 
-## Orienting yourself to a new project
+## 选择一个项目加入贡献
 
 <aside markdown="1" class="pquote">
   <img src="https://avatars.githubusercontent.com/shaunagm?s=180" class="pquote-avatar" alt="avatar">
@@ -189,7 +189,7 @@ related:
 * **论坛或邮件列表:** 一些项目会实用会话式的主题（例如 _"How do I..."_ 或 _"What do you think about..."_ 来替代 Bug 报告或特性请求）。然而有一些项目关于讨论全部实用问题追踪。
 * **即时在线聊天:** 有一些项目会实用聊天频道（诸如 Slack 或 IRC），从而能够随意的谈话、协作和快速交流。
 
-## Finding a project to contribute to
+## 找一个项目开始贡献
 
 你读到这里，说明已经对于一个开源项目如何运作的有了清晰的认识，是该找一个合适的项目做贡献的时候了！
 
@@ -217,7 +217,7 @@ related:
 * [Up For Grabs](https://up-for-grabs.net/)
 * [像忍者一样贡献](https://contributor.ninja)
 
-### A checklist before you contribute
+### 提交贡献之前的检查列表
 
 当你找到了你打算贡献的项目时，在进一步行动之前，作一个快速的扫描工作，以确保项目是否接受贡献的。否则，你煞费苦心的工作可能没有任何的回报。
 
@@ -371,7 +371,7 @@ related:
   </p>
 </aside>
 
-## How to submit a contribution
+## 如何提交贡献
 
 你已经找到了你喜爱的项目，也已准备好贡献了，迫不及待、跃跃欲试了。好吧！以下就是带领你如何以正确的姿势作贡献。
 
@@ -483,15 +483,15 @@ related:
 
 如果这是你第一次提交 PR。可以浏览 [PR 制造](http://makeapullrequest.com/)的文档，这是 @kentcdodds 专门为初次创建 PR 的人写的公开的资料。
 
-## What happens after you submit a contribution
+## 当你提交了之后会发生什么
 
 很不错，你做到了！恭贺你成为开源贡献者。我们希望这是一个良好的开端。
 
 在你提交了贡献之后，下面几种情形中的某种是可能发生的：
 
 ### 😭 没有人响应你。
 
-希望你确认在开始工作之前[检查过了项目的活跃度](#a-checklist-before-you-contribute)，不过即使检查过了，也不保证一个活跃的项目，没有人理会你的贡献也是很正常的。
+希望你确认在开始工作之前[检查过了项目的活跃度](#提交贡献之前的检查列表)，不过即使检查过了，也不保证一个活跃的项目，没有人理会你的贡献也是很正常的。
 
 如果过去了一周，依旧没有人响应，请心平气和的在后面跟帖，询求他人帮助你审核下。如果你熟悉某个人可以审核你的贡献，你可以使用@+名字，直接提醒他一下。
 
@@ -515,7 +515,7 @@ related:
 
 太棒了！你已经成功的做到了，为开源做贡献也不过如此！
 
-## You did it!
+## 你做到了!
 
 你刚刚完成了自己的开源贡献处女秀，接下来，你可能打算寻找另外的方法来做贡献，希望本文给你提供了灵感和实践。即使是你的贡献没有被采纳或接收，也不要有失风度，请对帮助过你的维护者表示感谢！