Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion _articles/zh-hans/best-practices.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ redirect_from: /zh-cn/best-practices/

有一个明确的,用文档表达清晰的愿景,能保证项目的走向不会跑偏,同时也能保障因为其他的贡献者增加的奇怪的需求而使项目变质。

比如,@lord 发现项目有一个明确的愿景能够帮助他决定哪个 PR 值得花时间。作为一个维护者的新手,他甚至还后悔当他接到第一个关于 [slate](https://github.com/lord/slate)) PR 的时候没有坚持项目本身的原则。
比如,@lord 发现项目有一个明确的愿景能够帮助他决定哪个 PR 值得花时间。作为一个维护者的新手,他甚至还后悔当他接到第一个关于 [slate](https://github.com/lord/slate) PR 的时候没有坚持项目本身的原则。

<aside markdown="1" class="pquote">
<img src="https://avatars.githubusercontent.com/lord?s=180" class="pquote-avatar" alt="avatar">
Expand Down
4 changes: 2 additions & 2 deletions _articles/zh-hans/finding-users.md
Original file line number Diff line number Diff line change
Expand Up @@ -80,7 +80,7 @@ redirect_from: /zh-cn/finding-users/

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

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

Expand Down Expand Up @@ -144,6 +144,6 @@ redirect_from: /zh-cn/finding-users/

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

## 保持下去!
## 保持下去

有时候,让人们关注你的开源项目会花费很多时间。没关系!一些今天很流行的项目都是花了很多年才有如今的高活跃度的。把重点放在建立声誉上而不要企图一夜成名。保持耐心,请一如既往地和那些可能会从中受益的人分享你的项目。
4 changes: 2 additions & 2 deletions _articles/zh-hans/getting-paid.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ redirect_from: /zh-cn/getting-paid/

<aside markdown="1" class="pquote">
<img src="https://avatars.githubusercontent.com/gvanrossum?s=180" class="pquote-avatar" alt="avatar">
我尝试着寻找让人爱不释手的编程项目,从而使我的周末或圣诞节也能保持状态。(...)我拥有一台家用电脑,手头也并不十分宽裕。在思考了一阵子之后,我决定写一新的交互式的编程语言,...)后来我将这门语言叫做Python。
我尝试着寻找让人爱不释手的编程项目,从而使我的周末或圣诞节也能保持状态。(...)我拥有一台家用电脑,手头也并不十分宽裕。在思考了一阵子之后,我决定写一新的交互式的编程语言,(...)后来我将这门语言叫做Python。
<p markdown="1" class="pquote-credit">
— @gvanrossum, ["Python 编程"](https://www.python.org/doc/essays/foreword/)
</p>
Expand Down Expand Up @@ -73,7 +73,7 @@ redirect_from: /zh-cn/getting-paid/

@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) :

> 开源能够与我们 Hacker 文化密切配合,也能够和我们的组织融洽。我们询问员工:"在 Facebook 真的那么的在意开源软件?" 超过2/3的人的回答是"yes"。一半的人表示,该计划对他们为我们工作的决定作出了积极的贡献。这可不是一个戏谑的数字,我们希望继续保持这样。
> 开源能够与我们 Hacker 文化密切配合,也能够和我们的组织融洽。我们询问员工:在 Facebook 真的那么的在意开源软件? 超过2/3的人的回答是"yes"。一半的人表示,该计划对他们为我们工作的决定作出了积极的贡献。这可不是一个戏谑的数字,我们希望继续保持这样。

如果你所在的公司不赞同这么做,没关系,重要的是保持社区和企业活动之间的界限清晰。你要告诉老板,开源的维持是由全球各地的人所贡献,要比任何一个公司或某一地域都大的多。老板会自己作出权衡的。

Expand Down
12 changes: 6 additions & 6 deletions _articles/zh-hans/how-to-contribute.md
Original file line number Diff line number Diff line change
Expand Up @@ -249,7 +249,7 @@ redirect_from: /zh-cn/how-to-contribute/
<div class="clearfix mb-4">
<input type="checkbox" id="cbox4" class="d-block float-left mt-1 mr-2" value="checkbox">
<label for="cbox4" class="overflow-hidden d-block text-normal">
人们提交的频繁吗? (在 GitHub,可以在顶栏里点击"commits"来展现。)
人们提交的频繁吗? 在 GitHub,可以在顶栏里点击"commits"来展现。)
</label>
</div>

Expand Down Expand Up @@ -286,7 +286,7 @@ redirect_from: /zh-cn/how-to-contribute/
<div class="clearfix mb-4">
<input type="checkbox" id="cbox9" class="d-block float-left mt-1 mr-2" value="checkbox">
<label for="cbox9" class="overflow-hidden d-block text-normal">
有没有关闭的issue? (在 GitHub, 点击 "closed" 标签就可以看到所有已经关闭的 issue。)
有没有关闭的issue? 在 GitHub, 点击 "closed" 标签就可以看到所有已经关闭的 issue。
</label>
</div>

Expand Down Expand Up @@ -323,7 +323,7 @@ redirect_from: /zh-cn/how-to-contribute/
<div class="clearfix mb-4">
<input type="checkbox" id="cbox13" class="d-block float-left mt-1 mr-2" value="checkbox">
<label for="cbox13" class="overflow-hidden d-block text-normal">
最近有多少 PR 合并? (在 GitHub, 点击 PR 页面的 "closed" 的标签页来查看已经关闭的标签页。)
最近有多少 PR 合并? 在 GitHub, 点击 PR 页面的 "closed" 的标签页来查看已经关闭的标签页。
</label>
</div>

Expand Down Expand Up @@ -463,14 +463,14 @@ redirect_from: /zh-cn/how-to-contribute/

在下面的情形时,请你务必使用PR:

* 提交补丁 (例如,纠正拼写错误、损坏的链接、或者是其它较明显的错误)
* 提交补丁 例如,纠正拼写错误、损坏的链接、或者是其它较明显的错误)
* 开始一项别人请求的任务,或者是过去在 issue 中早就讨论过的

一个 PR 并不代表着工作已经完成。它通常是尽早的开启一个 PR,是为了其他人可以观看或者给作者反馈意见。只需要在子标题标记为"WIP"(正在进行中)。作者可以在后面添加很多评论。

如果说项目是托管在 GitHub 上的,以下是我们总结出的提交 PR 的建议:

* **[Fork 代码仓库](https://guides.github.com/activities/forking/)** 并克隆到本地,在本地的仓库配置"上游"为远端仓库。这样你可以在提交你的 PR 时保持和"上游"同步,会减少很多解决冲突的时间。(更多关于同步的说明,请参考[这里](https://help.github.com/articles/syncing-a-fork/).)
* **[Fork 代码仓库](https://guides.github.com/activities/forking/)** 并克隆到本地,在本地的仓库配置"上游"为远端仓库。这样你可以在提交你的 PR 时保持和"上游"同步,会减少很多解决冲突的时间。更多关于同步的说明,请参考[这里](https://help.github.com/articles/syncing-a-fork/).
* **[创建一个分支](https://guides.github.com/introduction/flow/)** 用于自己编辑。
* **参考任何相关的issue** 或者在你的 PR 中支持文档(比如. "Closes #37.")
* **包含之前和之后的快照** 如果你的改动是包含了不同的 HTML/CSS。在你的 PR 中加入相应的图片。
Expand Down Expand Up @@ -511,7 +511,7 @@ redirect_from: /zh-cn/how-to-contribute/

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

## 你做到了!
## 你做到了

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

Expand Down
2 changes: 1 addition & 1 deletion _articles/zh-hans/leadership-and-governance.md
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,7 @@ redirect_from: /zh-cn/leadership-and-governance/

<aside markdown="1" class="pquote">
<img src="https://avatars.githubusercontent.com/jacobian?s=180" class="pquote-avatar" alt="avatar">
你们或许知道我是 Django 的"创始人"...其实真相是在有人雇佣了我之后一年才真正的做出来。(...) 人们猜测我的成功是因为我的编程技能够牛...但事实上我的编程水平只是一般般而已。
你们或许知道我是 Django 的创始人...其实真相是在有人雇佣了我之后一年才真正的做出来。(...) 人们猜测我的成功是因为我的编程技能够牛...但事实上我的编程水平只是一般般而已。
<p markdown="1" class="pquote-credit">
— @jacobian, ["PyCon 2015 Keynote" (视频)](https://www.youtube.com/watch?v=hIJdFxYlEKE#t=5m0s)
</p>
Expand Down
5 changes: 2 additions & 3 deletions _articles/zh-hans/legal.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ redirect_from: /zh-cn/legal/
</p>
</aside>

## 我的项目适合什么样的开源许可?
## 我的项目适合什么样的开源许可

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

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

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

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

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

Expand Down Expand Up @@ -122,7 +122,6 @@ redirect_from: /zh-cn/legal/

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


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

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

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

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

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

Expand Down
6 changes: 3 additions & 3 deletions _articles/zh-hans/starting-a-project.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ related:
redirect_from: /zh-cn/starting-a-project/
---

## 什么是开源,为什么要开源
## 什么是开源为什么要开源

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

Expand All @@ -23,7 +23,7 @@ redirect_from: /zh-cn/starting-a-project/

接下来我们通过一个例子了解它的工作原理。想象你的朋友组织了一场聚餐,而你带去了一个樱桃派。

* 每个人都尝了那个派(_使用_)
* 每个人都尝了那个派(_使用_
* 派的味道棒极了!大家请你分享它的配方(_view_)
* 一个叫 Alex 的朋友是个糕点师,他建议少放点糖(_modify_)
* 一个叫 Lisa 的朋友想要用它作为下周的晚餐(_distribute_)
Expand Down Expand Up @@ -359,6 +359,6 @@ redirect_from: /zh-cn/starting-a-project/
</label>
</div>

## 你做到了!
## 你做到了

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