— @shaunagm, ["如何为开源做贡献"](https://readwrite.com/2014/10/10/open-source-diversity-how-to-contribute/)
@@ -172,21 +172,21 @@ related:
* **贡献者:** 只要是为项目做出了贡献,就算。
* **社区成员:** 那些实用项目的人们。他们或许是积极的讨论者,又或者是为项目的方向提出意见的人。
-一个较大的项目,可能下面还会细分子社区,或者是针对不同的任务分成不同的小组,比如工具小组、分流、社区事务、以及活动组织等。径直到项目到web站点,找到"团队"页面,或者是查看治理文档,从而获得类似到信息。
+一个较大的项目,可能下面还会细分子社区,或者是针对不同的任务分成不同的小组,比如工具小组、分流、社区事务、以及活动组织等。径直到项目到 web 站点,找到"团队"页面,或者是查看治理文档,从而获得类似到信息。
-靠谱的开源项目,一般都会有一个文档的,这些文档文件通常会在代码仓库的顶级目录列出。
+靠谱的开源项目,一般都会有文档的,这些文档文件通常会在代码仓库的顶级目录列出。
-* **许可协议:** 根据开源软件的定义,每一个开源项目必须是有[开源许可协议](https://choosealicense.com)的. 可以这么认为:假如说某个项目源码开放,但是没有任何的许可协议,那么它就不能叫做开源。
-* **README:** README 是一个介绍性的说明文件,对初次光临社区对人们表示欢迎,它通常会解释项目有何用处,为何发起,以及如何快速入门等。
-* **贡献:** READMES 帮助人们来认识项目,贡献这个文件则是帮助对项目如何做贡献。它解释了目前项目需要什么样类型对贡献者,社区对流程是啥样的。并非所有的项目都会有这个文件,它某种程度上也是展示项目对于贡献者的友好程度。
-* **行为准则:** 顾名思义,即是一些参与社区时的一些礼仪、说话方式、行为等,帮助形成一种友好的氛围,不是所有的项目都会撰写行为准则文件,它某种程度上也是展示项目对于贡献者的友好程度。
+* **LICENSE:** 根据开源软件的定义,每一个开源项目必须是有[开源许可协议](https://choosealicense.com)的. 可以这么认为:假如说某个项目源码开放,但是没有任何的许可协议,那么它就不能叫做开源。
+* **README:** README 是一个介绍性的说明文件,对初次光临社区的人们表示欢迎,它通常会解释项目有何用处,为何发起,以及如何快速入门等。
+* **CONTRIBUTING:** READMEs 帮助人们来认识项目,CONTRIBUTING 这个文件则是帮助对项目如何做贡献。它解释了目前项目需要什么样类型对贡献者,社区的流程是什么样的。并非所有的项目都会有这个文件,它某种程度上也是展示项目对于贡献者的友好程度。
+* **CODE_OF_CONDUCT:** 顾名思义,即是一些参与社区时的一些礼仪、说话方式、行为等,帮助形成一种友好的氛围,不是所有的项目都会撰写行为准则文件,它某种程度上也是展示项目对于贡献者的友好程度。
* **其它文档:** 有些项目也许还有其它文档,例如教程、导游,或者是治理规则,这在大型项目中常见。
此外,开源项目还会利用如下一些工具来进行组织讨论,阅读这些归档对于理解社区的想法、是如何工作的有非常大的作用。
* **问题追踪:** 这里是人们讨论项目相关问题的地方。
* **Pull requests:** 审核代码、以及相关的问题讨论。
-* **论坛或邮件列表:** 一些项目会实用会话式的主题(例如 _"How do I..."_ 或 _"What do you think about..."_ 来替代Bug报告或特性请求)。然而有一些项目关于讨论全部实用问题追踪。
+* **论坛或邮件列表:** 一些项目会实用会话式的主题(例如 _"How do I..."_ 或 _"What do you think about..."_ 来替代 Bug 报告或特性请求)。然而有一些项目关于讨论全部实用问题追踪。
* **即时在线聊天:** 有一些项目会实用聊天频道(诸如 Slack 或 IRC),从而能够随意的谈话、协作和快速交流。
## Finding a project to contribute to
@@ -203,7 +203,7 @@ related:
开源并不是高级俱乐部;它就是由你这样的人所浇铸和打造。**"开源"只是针对这个世界的需要修复的问题的一个梦幻术语罢了。**
-你或许在查看 README的时候,发现了损坏的链接,又或者拼写错误。又或者是你是一名新手,使用的过程中发现了问题,又或者是某问题应该在文档中注明。请不要坐视不理,径直绕开,或者是请求他人修复,伸出你的援助之手,解决这些你能看到的问题。而这正是开源的精髓之所在!
+你或许在查看 README 的时候,发现了损坏的链接,又或者拼写错误。又或者是你是一名新手,使用的过程中发现了问题,又或者是某问题应该在文档中注明。请不要坐视不理,径直绕开,或者是请求他人修复,伸出你的援助之手,解决这些你能看到的问题。而这正是开源的精髓之所在!
> [28% 的随意贡献](https://www.igor.pro.br/publica/papers/saner2016.pdf) 就是说明了文档的开源,诸如拼写错误,段落语句调整、或者是翻译。
@@ -234,7 +234,7 @@ related:
**项目被接收的提交活跃度**
-在主干上确认提交的活跃度。在GitHub上托管的开源项目,你可以在仓库主页上看到这些信息。
+在主干上确认提交的活跃度。在 GitHub 上托管的开源项目,你可以在仓库主页上看到这些信息。
@@ -269,14 +269,14 @@ related:
@@ -290,23 +290,23 @@ related:
-同样再来看看 PR的情形。
+同样再来看看 PR 的情形。
@@ -320,14 +320,14 @@ related:
@@ -338,21 +338,21 @@ related:
@@ -381,7 +381,7 @@ related: