Skip to content

Commit 5730b11

Browse files
committed
docs(_articles/zh-hans): correct symbol in zh-hans documents
Use the Chinese punctuation mark in zh-hans document. Signed-off-by: OctagonalStar <76486554+OctagonalStar@users.noreply.github.com>
1 parent ca4eb9d commit 5730b11

File tree

8 files changed

+22
-23
lines changed

8 files changed

+22
-23
lines changed

_articles/zh-hans/best-practices.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -243,7 +243,7 @@ fork 一个项目不什么坏事情。能复制并且修改别人的代码是开
243243

244244
开源项目曾经让你开心,但可能现在开始让你不开心了。
245245

246-
可能当你想到你的项目的时候感觉到"亚历山大"。而同时,issue 和 PR 又纷至沓来。
246+
可能当你想到你的项目的时候感觉到亚历山大。而同时,issue 和 PR 又纷至沓来。
247247

248248
疲倦在开源工作工作中是一个常见的问题,特别是在维护者中间。作为一个维护者,你做的开心对项目的生存来说是一个没有商量余地的条件。
249249

_articles/zh-hans/finding-users.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -54,13 +54,13 @@ redirect_from: /zh-cn/finding-users/
5454

5555
**考虑给你的项目做个网站**一个网站可以让你的项目更加友好,也更加容易浏览,更重要的是附上清晰的文档和教程。这也证明你的项目是活跃的,会让你的用户更放心地使用项目。可以用一些例子告诉人们如何使用你的项目。
5656

57-
[@adrianholovaty](https://news.ycombinator.com/item?id=7531689), Django 的作者说,我们给 Django 做的网站可以说是"在早期开发 Django 的时候做的最好的一件事情了"
57+
[@adrianholovaty](https://news.ycombinator.com/item?id=7531689), Django 的作者说,我们给 Django 做的网站可以说是在早期开发 Django 的时候做的最好的一件事情了
5858

5959
如果你的项目是托管在 GitHub 上的,你可以用 [GitHub Pages](https://pages.github.com/) 简单创建一个网站。[Yeoman](http://yeoman.io/)[Vagrant](https://www.vagrantup.com/)[Middleman](https://middlemanapp.com/) 是一些内容详细的优质网站[示例](https://github.com/showcases/github-pages-examples)
6060

6161
![vagrant homepage](/assets/images/finding-users/vagrant_homepage.png)
6262

63-
现在你的项目有了"卖点"和容易被人们发现的渠道,接下来我们谈谈如何与你的用户交流吧!
63+
现在你的项目有了“卖点”和容易被人们发现的渠道,接下来我们谈谈如何与你的用户交流吧!
6464

6565
## 在网上寻找你项目的用户
6666

@@ -80,7 +80,7 @@ redirect_from: /zh-cn/finding-users/
8080

8181
* **快速找一下有没有相关的开源项目和社区**。有时候,你不要直接宣传你的项目。如果你的项目对使用 Python 的数据科学家来说是无可挑剔的,那么就去 Python 数据科学的社区宣传。等他们知道你的项目之后,很自然的就会谈论然后分享你的成果。
8282
* **如果你的项目能够解决特定问题,找到会遇到这些问题的人**。想想你的项目受众会在哪些论坛,然后搜索这些论坛,回答他们提出的问题,然后找一个合适的时机,向他们建议使用你的项目来作为一种解决方案。
83-
* **寻求反馈**。向可能会用到你项目的人介绍你自己和你的项目。请确保这些人是从你项目中受益的人。试着完善下面这句话:"我觉得我的项目能够帮助到 A,或者那些尝试做 B 事情的人"。不要只是简单地宣传,更需要学会倾听和回复别人的反馈。
83+
* **寻求反馈**。向可能会用到你项目的人介绍你自己和你的项目。请确保这些人是从你项目中受益的人。试着完善下面这句话:我觉得我的项目能够帮助到 A,或者那些尝试做 B 事情的人。”不要只是简单地宣传,更需要学会倾听和回复别人的反馈。
8484

8585
通常,你应该先想着帮助别人而不是获取回报。因为在网上宣传一个项目对任何人来说都很简单,所以肯定会有很多人在做同样的事情。告诉人们你是谁,而不是你想要什么,这样才能从众多宣传者中脱颖而出。
8686

@@ -144,6 +144,6 @@ redirect_from: /zh-cn/finding-users/
144144

145145
建立用户基础并不是一蹴而就的。获取别人的信任和尊重需要时间,同样,建立声誉也需要一直坚持下去。
146146

147-
## 保持下去!
147+
## 保持下去
148148

149149
有时候,让人们关注你的开源项目会花费很多时间。没关系!一些今天很流行的项目都是花了很多年才有如今的高活跃度的。把重点放在建立声誉上而不要企图一夜成名。保持耐心,请一如既往地和那些可能会从中受益的人分享你的项目。

_articles/zh-hans/getting-paid.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -73,7 +73,7 @@ redirect_from: /zh-cn/getting-paid/
7373

7474
@hueniverse ,举例来说,有充足的证据证明 [沃尔玛对开源的投资](https://hueniverse.com/2014/08/15/open-source-aint-charity/)是合理的。 @jamesgpearce 同样,Facebook 的开源项目让它的招聘显得[与众不同](https://opensource.com/business/14/10/head-of-open-source-facebook-oscon) :
7575

76-
> 开源能够与我们 Hacker 文化密切配合,也能够和我们的组织融洽。我们询问员工:"在 Facebook 真的那么的在意开源软件?" 超过2/3的人的回答是"yes"。一半的人表示,该计划对他们为我们工作的决定作出了积极的贡献。这可不是一个戏谑的数字,我们希望继续保持这样。
76+
> 开源能够与我们 Hacker 文化密切配合,也能够和我们的组织融洽。我们询问员工:在 Facebook 真的那么的在意开源软件? 超过2/3的人的回答是"yes"。一半的人表示,该计划对他们为我们工作的决定作出了积极的贡献。这可不是一个戏谑的数字,我们希望继续保持这样。
7777
7878
如果你所在的公司不赞同这么做,没关系,重要的是保持社区和企业活动之间的界限清晰。你要告诉老板,开源的维持是由全球各地的人所贡献,要比任何一个公司或某一地域都大的多。老板会自己作出权衡的。
7979

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -511,7 +511,7 @@ redirect_from: /zh-cn/how-to-contribute/
511511

512512
太棒了!你已经成功地完成了一次开源贡献!
513513

514-
## 你做到了!
514+
## 你做到了
515515

516516
你刚刚完成了自己的第一次开源贡献,接下来,你可能打算寻找另外的方法来做贡献,希望本文给你提供了灵感去实践。即使你的贡献没有被采纳,也请对帮助过你的维护者表示感谢!
517517

_articles/zh-hans/leadership-and-governance.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,7 @@ redirect_from: /zh-cn/leadership-and-governance/
4545

4646
<aside markdown="1" class="pquote">
4747
<img src="https://avatars.githubusercontent.com/jacobian?s=180" class="pquote-avatar" alt="avatar">
48-
你们或许知道我是 Django 的"创始人"...其实真相是在有人雇佣了我之后一年才真正的做出来。(...) 人们猜测我的成功是因为我的编程技能够牛...但事实上我的编程水平只是一般般而已。
48+
你们或许知道我是 Django 的创始人...其实真相是在有人雇佣了我之后一年才真正的做出来。(...) 人们猜测我的成功是因为我的编程技能够牛...但事实上我的编程水平只是一般般而已。
4949
<p markdown="1" class="pquote-credit">
5050
@jacobian, ["PyCon 2015 Keynote" (视频)](https://www.youtube.com/watch?v=hIJdFxYlEKE#t=5m0s)
5151
</p>
@@ -59,7 +59,7 @@ redirect_from: /zh-cn/leadership-and-governance/
5959

6060
对于稍大型点的项目,如果你已经拥有了网页的话,那么请创建一个团队的页面,或者创建一个团队领导的页面。举例来说, [PostgreSQL](https://github.com/postgres/postgres/) 就拥有一个[很全面的团队页面](https://www.postgresql.org/community/contributors/) ,而且每位贡献者都拥有简短的介绍。
6161

62-
如果你的项目拥有非常活跃的贡献者社区,你或许会专门建立一个维护者的"核心团队",甚至是根据不同的话题所有者成立子的委员会(例如,安全,问题筛选,或者是社区准则)。让人们自行组织、且能够让志愿者自行找到自己喜欢的角色,而不是去分配他们。
62+
如果你的项目拥有非常活跃的贡献者社区,你或许会专门建立一个维护者的核心团队,甚至是根据不同的话题所有者成立子的委员会(例如,安全,问题筛选,或者是社区准则)。让人们自行组织、且能够让志愿者自行找到自己喜欢的角色,而不是去分配他们。
6363

6464
<aside markdown="1" class="pquote">
6565
\[我们\] 为核心团队设立多个"子团队"。每个子团队都会专门的聚焦于某个特定的领域,举例来说,语言设计或程序库(...) 为了确保全局的协调和健壮,会将整体的项目设置为同一个愿景,每个子团队是由核心团队的一员。
@@ -98,9 +98,9 @@ redirect_from: /zh-cn/leadership-and-governance/
9898

9999
关于开源项目有三类通用的相关治理结构。
100100

101-
* **BDFL:** BDFL 是 "终身仁慈独裁者" 的缩写. 在此结构下,有一个人(通常是项目的最初的作者)拥有项目中所有的最后决定权。[Python](https://github.com/python) 就是一个非常经典的例子。较小的项目可能默认就是 BDFL 结构,因为他一般就是一到两位维护者。若是公司组织的项目也极有可能会采用BDFL结构。
101+
* **BDFL:** BDFL 是 终身仁慈独裁者 的缩写. 在此结构下,有一个人(通常是项目的最初的作者)拥有项目中所有的最后决定权。[Python](https://github.com/python) 就是一个非常经典的例子。较小的项目可能默认就是 BDFL 结构,因为他一般就是一到两位维护者。若是公司组织的项目也极有可能会采用BDFL结构。
102102

103-
* **精英制:** **(注: 术语 "精英制" 对于一些社群可能具有消极的含义,其拥有较[复杂的社会和政治的历史](http://geekfeminism.wikia.com/wiki/Meritocracy).)** 在精英制下,活跃的项目贡献者(他们用行动证明自己是"精英")给一个正式的决策作用,决定通常会基于纯粹的投票一致性。精英制的概念首次由[Apache Foundation](https://www.apache.org/)提出;[所有的Apache 项目](https://www.apache.org/index.html#projects-list) 都是基于精英制的。贡献者只能代表自己是独立的个体,不可以是公司。
103+
* **精英制:** **(注: 术语 "精英制" 对于一些社群可能具有消极的含义,其拥有较[复杂的社会和政治的历史](http://geekfeminism.wikia.com/wiki/Meritocracy).)** 在精英制下,活跃的项目贡献者(他们用行动证明自己是“精英”)给一个正式的决策作用,决定通常会基于纯粹的投票一致性。精英制的概念首次由[Apache Foundation](https://www.apache.org/)提出;[所有的Apache 项目](https://www.apache.org/index.html#projects-list) 都是基于精英制的。贡献者只能代表自己是独立的个体,不可以是公司。
104104

105105
* **自由贡献:** 在自由贡献的模式下,做最多工作的人通常被认为是最具影响力的,但是是基于当前的工作,而不是历史的贡献。项目的重大决策是基于寻求共识的过程(对不同的声音要讨论)而不是纯粹的投票,尽可能的努力的去囊括多的社区观点。较流行的使用自由贡献模式的项目有[Node.js](https://foundation.nodejs.org/)[Rust](https://www.rust-lang.org/)
106106

@@ -134,7 +134,7 @@ redirect_from: /zh-cn/leadership-and-governance/
134134

135135
将商业的活动视为正常不过的事情很重要,它也只是代码的开发方法之一。为开发者付费不应该被特殊的对待,好像代码必须是无偿开发的才行;每个贡献都必须有技术的衡量标准来进行评估。人们应该在这些商业的活动中感到非常的自在,而且针对特定的增强或功能项讨论时也应是坦荡的、自然的。
136136

137-
"商业" 是完全和"开源"相容的。"商业"仅仅是意味着某些地方有钱的参与 —— 就是说软件被用于了商业行为,也就是说项目被采用获得了认可。(当开源软件被用于非开源产品的一个部分时,这个整体的产品仍然是"专有的"软件,因为开源,它可以用于商业或非商业的目的。)
137+
“商业” 是完全和“开源”相容的。“商业”仅仅是意味着某些地方有钱的参与 —— 就是说软件被用于了商业行为,也就是说项目被采用获得了认可。(当开源软件被用于非开源产品的一个部分时,这个整体的产品仍然是"专有的"软件,因为开源,它可以用于商业或非商业的目的。)
138138

139139
和这个世界上很多的其它商业产品一样,商业能够激励开发者去积极的贡献于项目,通过他们靠谱的提交贡献。显而易见的是,一位因花了自己的时间和精力的开发者获得报酬,理应比没有获得报酬的更具持久性,当然,这对于某些圣徒是不成立的,或者这么说吧,报酬是能体现一个贡献度的众多衡量因素的其中之一。所以将你的项目讨论聚焦于贡献上,不要让人们分散精力去思考或做其它的事情。
140140

_articles/zh-hans/legal.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -53,7 +53,7 @@ redirect_from: /zh-cn/legal/
5353
</p>
5454
</aside>
5555

56-
## 我的项目适合什么样的开源许可?
56+
## 我的项目适合什么样的开源许可
5757

5858
如果你们是从头开始的,那么使用[MIT License](https://choosealicense.com/licenses/mit/),不容易出错。它很短,很容易理解,并允许任何人做任何事情,只要他们保留许可证的副本,包括你们的版权声明。如果你们需要,您们能够根据不同的许可协议发布项目。
5959

@@ -73,7 +73,7 @@ redirect_from: /zh-cn/legal/
7373

7474
当你们在GitHub上创建了一个新项目,它给你们提供了选择许可协议的选项。包括上面提到的可以使你们的GitHub项目开源的许可协议。如果你们想要了解其他选择,可以通过查阅[choosealicense.com](https://choosealicense.com)找到适合你们项目(即使它[不是软件](https://choosealicense.com/non-software/))的许可协议。
7575

76-
## 如果我想修改开源许可该怎么办?
76+
## 如果我想修改开源许可该怎么办
7777

7878
大多数项目绝不需要更换许可协议。但是情况偶尔有变。
7979

@@ -122,7 +122,6 @@ redirect_from: /zh-cn/legal/
122122

123123
* **第三方资源:**你们的项目有其他人创建的依赖或者使用他人的代码?如果这些是开源项目,你们需要遵守第三方资源的开源许可协议。首先,选择与第三方资源的开放源许可协议一起使用的许可协议(见上文)。如果你们的项目修改或者发布第三方开源资源,那么你们法律团队还想知道你们符合第三方开源许可协议的其他条件,例如保留版权声明。如果你们使用了其他没有开源许可协议的代码,那么你们可能会要求第三方资源的维护者[添加一个开源许可协议](https://choosealicense.com/no-license/#for-users),要是你们得不到许可,你们只能停止使用他们的代码。
124124

125-
126125
* **商业机密:**请考虑项目中是否有公司不想对外公开的东西。如果是这样的话,你们只能开源项目的一部分,得保护好公司的商业机密。
127126

128127
* **专利:**你们公司是否申请了与你们项目有关的专利?如果开源源代码,这会对公司的专利进行[公开披露](https://en.wikipedia.org/wiki/Public_disclosure)。可悲的是,你们可能被要求等待(或者公司会重新思考应用程序)。如果你们期望从拥有大量专利组合的公司的员工那里得到贡献,们的法律团队可能希望你们使用来自贡献者的明确专利授权的许可协议(例如Apache 2.0或GPLv3)或其他贡献者协议(见上文)。

_articles/zh-hans/security-best-practices-for-your-project.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ image: /assets/images/cards/security-best-practices.png
1414

1515
### 一旦恶意攻击者成功冒充特权贡献者,后果将不堪设想。
1616

17-
获得特殊访问权限后,攻击者便可以篡改代码使其执行恶意操作(例如挖掘加密货币),或向项目用户的基础设施分发恶意软件,抑或访问私有代码仓库(repository)以窃取知识产权及敏感数据(包括其他服务的凭证)。
17+
获得特殊访问权限后,攻击者便可以篡改代码使其执行恶意操作(例如挖掘加密货币),或向项目用户的基础设施分发恶意软件,抑或访问私有代码仓库(repository)以窃取知识产权及敏感数据(包括其他服务的凭证)。
1818

1919
多因素认证(Multi-Factor Authentication)为账户安全增加了一道防线。一经启用,除了用户名和口令(password),您还需要额外提供一种您独有的身份认证信息,才能完成登录。
2020

_articles/zh-hans/starting-a-project.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -11,11 +11,11 @@ related:
1111
redirect_from: /zh-cn/starting-a-project/
1212
---
1313

14-
## 什么是开源,为什么要开源
14+
## 什么是开源为什么要开源
1515

1616
如果你正在考虑开始参与开源,那么恭喜你!世界会感激你的贡献。首先我们来谈谈什么是开源以及为什么我们要开源。
1717

18-
### "开源"是什么意思?
18+
### “开源”是什么意思?
1919

2020
当一个项目被开源,这意味着**任何人都可以出于任何目的查看,使用,修改和分发你的项目**。 这些权限通过[开源许可](https://opensource.org/licenses)强制实施。
2121

@@ -50,13 +50,13 @@ redirect_from: /zh-cn/starting-a-project/
5050

5151
开源并不仅仅限于软件。您可以开源任何事物,从数据集到书本。查看 [GitHub Explore](https://github.com/explore) 来找找有什么是你可以开源的。
5252

53-
### 开源是指"免费"吗?
53+
### 开源是指“免费”吗?
5454

55-
开源最大的吸引之一是它不花钱。 但是,"免费"只是开源的总体价值的一小部分。
55+
开源最大的吸引之一是它不花钱。 但是,“免费”只是开源的总体价值的一小部分。
5656

5757
因为[开源许可证要求](https://opensource.org/osd-annotated)任何人可以几乎出于任何目的使用,修改和共享您的项目,项目本身往往是免费的。 如果该项目花钱使用,任何人也都可以合法地复制和使用免费版本。
5858

59-
因此,大多数开源项目是免费的,但"免费"不是开源定义的一部分。 有些方法可以通过双重许可或有限功能间接地为开源项目收费,同时仍然遵守开源的官方定义。
59+
因此,大多数开源项目是免费的,但“免费”不是开源定义的一部分。 有些方法可以通过双重许可或有限功能间接地为开源项目收费,同时仍然遵守开源的官方定义。
6060

6161
## 我应该开始自己的开源项目吗?
6262

@@ -255,7 +255,7 @@ redirect_from: /zh-cn/starting-a-project/
255255
</p>
256256
</aside>
257257

258-
使用热情,通俗易懂的语言(如"他们",即使是指一个人)能够让新来的贡献者感觉项目非常欢迎他们。使用简单的语言,因为你的读者可能英语不是很好。
258+
使用热情,通俗易懂的语言(如“他们”,即使是指一个人)能够让新来的贡献者感觉项目非常欢迎他们。使用简单的语言,因为你的读者可能英语不是很好。
259259

260260
除了书写风格外,你的编码风格也是你项目品牌的一部分。 [Angular](https://github.com/johnpapa/angular-styleguide)[jQuery](https://contribute.jquery.org/style-guide/js/)是两个项目代码风格严谨的示例和指南。
261261

@@ -359,6 +359,6 @@ redirect_from: /zh-cn/starting-a-project/
359359
</label>
360360
</div>
361361

362-
## 你做到了!
362+
## 你做到了
363363

364364
恭喜你开源了你的首个项目。不论结果如何,对开源社区都是一份礼物。随着每次commit,comment和pull request,你正在为自己或者他人创造学习和成长的机会。

0 commit comments

Comments
 (0)