From ca4eb9d0209940831b0142737441b03b39d10287 Mon Sep 17 00:00:00 2001
From: OctagonalStar <76486554+OctagonalStar@users.noreply.github.com>
Date: Fri, 21 Nov 2025 22:48:12 +0800
Subject: [PATCH 1/4] docs(_articles/zh-hans): correct brackets in zh-hans
documents
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
The original zh-hans document used a mix of Chinese brackets("(" or ")") and English brackets incorrectly.
Signed-off-by: OctagonalStar <76486554+OctagonalStar@users.noreply.github.com>
---
_articles/zh-hans/best-practices.md | 2 +-
_articles/zh-hans/how-to-contribute.md | 10 +++++-----
_articles/zh-hans/starting-a-project.md | 2 +-
3 files changed, 7 insertions(+), 7 deletions(-)
diff --git a/_articles/zh-hans/best-practices.md b/_articles/zh-hans/best-practices.md
index f68fbfe41ea..edc4b09aa07 100644
--- a/_articles/zh-hans/best-practices.md
+++ b/_articles/zh-hans/best-practices.md
@@ -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 的时候没有坚持项目本身的原则。
-## 我的项目适合什么样的开源许可?
+## 我的项目适合什么样的开源许可?
如果你们是从头开始的,那么使用[MIT License](https://choosealicense.com/licenses/mit/),不容易出错。它很短,很容易理解,并允许任何人做任何事情,只要他们保留许可证的副本,包括你们的版权声明。如果你们需要,您们能够根据不同的许可协议发布项目。
@@ -73,7 +73,7 @@ redirect_from: /zh-cn/legal/
当你们在GitHub上创建了一个新项目,它给你们提供了选择许可协议的选项。包括上面提到的可以使你们的GitHub项目开源的许可协议。如果你们想要了解其他选择,可以通过查阅[choosealicense.com](https://choosealicense.com)找到适合你们项目(即使它[不是软件](https://choosealicense.com/non-software/))的许可协议。
-## 如果我想修改开源许可该怎么办?
+## 如果我想修改开源许可该怎么办?
大多数项目绝不需要更换许可协议。但是情况偶尔有变。
@@ -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)或其他贡献者协议(见上文)。
diff --git a/_articles/zh-hans/security-best-practices-for-your-project.md b/_articles/zh-hans/security-best-practices-for-your-project.md
index 00156a8c8e5..d2eeca3e3d7 100644
--- a/_articles/zh-hans/security-best-practices-for-your-project.md
+++ b/_articles/zh-hans/security-best-practices-for-your-project.md
@@ -14,7 +14,7 @@ image: /assets/images/cards/security-best-practices.png
### 一旦恶意攻击者成功冒充特权贡献者,后果将不堪设想。
-获得特殊访问权限后,攻击者便可以篡改代码使其执行恶意操作(例如挖掘加密货币),或向项目用户的基础设施分发恶意软件,抑或访问私有代码仓库(repository)以窃取知识产权及敏感数据(包括其他服务的凭证)。
+获得特殊访问权限后,攻击者便可以篡改代码使其执行恶意操作(例如挖掘加密货币),或向项目用户的基础设施分发恶意软件,抑或访问私有代码仓库(repository)以窃取知识产权及敏感数据(包括其他服务的凭证)。
多因素认证(Multi-Factor Authentication)为账户安全增加了一道防线。一经启用,除了用户名和口令(password),您还需要额外提供一种您独有的身份认证信息,才能完成登录。
diff --git a/_articles/zh-hans/starting-a-project.md b/_articles/zh-hans/starting-a-project.md
index f55af99e671..10f30caa539 100644
--- a/_articles/zh-hans/starting-a-project.md
+++ b/_articles/zh-hans/starting-a-project.md
@@ -11,11 +11,11 @@ related:
redirect_from: /zh-cn/starting-a-project/
---
-## 什么是开源,为什么要开源
+## 什么是开源,为什么要开源
如果你正在考虑开始参与开源,那么恭喜你!世界会感激你的贡献。首先我们来谈谈什么是开源以及为什么我们要开源。
-### "开源"是什么意思?
+### “开源”是什么意思?
当一个项目被开源,这意味着**任何人都可以出于任何目的查看,使用,修改和分发你的项目**。 这些权限通过[开源许可](https://opensource.org/licenses)强制实施。
@@ -50,13 +50,13 @@ redirect_from: /zh-cn/starting-a-project/
开源并不仅仅限于软件。您可以开源任何事物,从数据集到书本。查看 [GitHub Explore](https://github.com/explore) 来找找有什么是你可以开源的。
-### 开源是指"免费"吗?
+### 开源是指“免费”吗?
-开源最大的吸引之一是它不花钱。 但是,"免费"只是开源的总体价值的一小部分。
+开源最大的吸引之一是它不花钱。 但是,“免费”只是开源的总体价值的一小部分。
因为[开源许可证要求](https://opensource.org/osd-annotated)任何人可以几乎出于任何目的使用,修改和共享您的项目,项目本身往往是免费的。 如果该项目花钱使用,任何人也都可以合法地复制和使用免费版本。
-因此,大多数开源项目是免费的,但"免费"不是开源定义的一部分。 有些方法可以通过双重许可或有限功能间接地为开源项目收费,同时仍然遵守开源的官方定义。
+因此,大多数开源项目是免费的,但“免费”不是开源定义的一部分。 有些方法可以通过双重许可或有限功能间接地为开源项目收费,同时仍然遵守开源的官方定义。
## 我应该开始自己的开源项目吗?
@@ -255,7 +255,7 @@ redirect_from: /zh-cn/starting-a-project/
-使用热情,通俗易懂的语言(如"他们",即使是指一个人)能够让新来的贡献者感觉项目非常欢迎他们。使用简单的语言,因为你的读者可能英语不是很好。
+使用热情,通俗易懂的语言(如“他们”,即使是指一个人)能够让新来的贡献者感觉项目非常欢迎他们。使用简单的语言,因为你的读者可能英语不是很好。
除了书写风格外,你的编码风格也是你项目品牌的一部分。 [Angular](https://github.com/johnpapa/angular-styleguide) 和 [jQuery](https://contribute.jquery.org/style-guide/js/)是两个项目代码风格严谨的示例和指南。
@@ -359,6 +359,6 @@ redirect_from: /zh-cn/starting-a-project/
-## 你做到了!
+## 你做到了!
恭喜你开源了你的首个项目。不论结果如何,对开源社区都是一份礼物。随着每次commit,comment和pull request,你正在为自己或者他人创造学习和成长的机会。
From 538be88e9bd1eb87e56abe48c78642f3b71f0924 Mon Sep 17 00:00:00 2001
From: OctagonalStar <76486554+OctagonalStar@users.noreply.github.com>
Date: Sat, 22 Nov 2025 10:30:39 +0800
Subject: [PATCH 3/4] docs(_articles/zh-hans): correct straight quote
fix retext-quotes warnings
Signed-off-by: OctagonalStar <76486554+OctagonalStar@users.noreply.github.com>
---
_articles/zh-hans/best-practices.md | 2 +-
_articles/zh-hans/finding-users.md | 6 +++---
_articles/zh-hans/leadership-and-governance.md | 8 ++++----
_articles/zh-hans/starting-a-project.md | 10 +++++-----
4 files changed, 13 insertions(+), 13 deletions(-)
diff --git a/_articles/zh-hans/best-practices.md b/_articles/zh-hans/best-practices.md
index 5f94cb90427..edc4b09aa07 100644
--- a/_articles/zh-hans/best-practices.md
+++ b/_articles/zh-hans/best-practices.md
@@ -243,7 +243,7 @@ fork 一个项目不什么坏事情。能复制并且修改别人的代码是开
开源项目曾经让你开心,但可能现在开始让你不开心了。
-可能当你想到你的项目的时候感觉到“亚历山大”。而同时,issue 和 PR 又纷至沓来。
+可能当你想到你的项目的时候感觉到"亚历山大"。而同时,issue 和 PR 又纷至沓来。
疲倦在开源工作工作中是一个常见的问题,特别是在维护者中间。作为一个维护者,你做的开心对项目的生存来说是一个没有商量余地的条件。
diff --git a/_articles/zh-hans/finding-users.md b/_articles/zh-hans/finding-users.md
index fff222dd83f..f4557de3864 100644
--- a/_articles/zh-hans/finding-users.md
+++ b/_articles/zh-hans/finding-users.md
@@ -54,13 +54,13 @@ redirect_from: /zh-cn/finding-users/
**考虑给你的项目做个网站**一个网站可以让你的项目更加友好,也更加容易浏览,更重要的是附上清晰的文档和教程。这也证明你的项目是活跃的,会让你的用户更放心地使用项目。可以用一些例子告诉人们如何使用你的项目。
-[@adrianholovaty](https://news.ycombinator.com/item?id=7531689), Django 的作者说,我们给 Django 做的网站可以说是“在早期开发 Django 的时候做的最好的一件事情了”。
+[@adrianholovaty](https://news.ycombinator.com/item?id=7531689), Django 的作者说,我们给 Django 做的网站可以说是"在早期开发 Django 的时候做的最好的一件事情了"。
如果你的项目是托管在 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)。

-现在你的项目有了“卖点”和容易被人们发现的渠道,接下来我们谈谈如何与你的用户交流吧!
+现在你的项目有了"卖点"和容易被人们发现的渠道,接下来我们谈谈如何与你的用户交流吧!
## 在网上寻找你项目的用户
@@ -80,7 +80,7 @@ redirect_from: /zh-cn/finding-users/
* **快速找一下有没有相关的开源项目和社区**。有时候,你不要直接宣传你的项目。如果你的项目对使用 Python 的数据科学家来说是无可挑剔的,那么就去 Python 数据科学的社区宣传。等他们知道你的项目之后,很自然的就会谈论然后分享你的成果。
* **如果你的项目能够解决特定问题,找到会遇到这些问题的人**。想想你的项目受众会在哪些论坛,然后搜索这些论坛,回答他们提出的问题,然后找一个合适的时机,向他们建议使用你的项目来作为一种解决方案。
-* **寻求反馈**。向可能会用到你项目的人介绍你自己和你的项目。请确保这些人是从你项目中受益的人。试着完善下面这句话:“我觉得我的项目能够帮助到 A,或者那些尝试做 B 事情的人。”不要只是简单地宣传,更需要学会倾听和回复别人的反馈。
+* **寻求反馈**。向可能会用到你项目的人介绍你自己和你的项目。请确保这些人是从你项目中受益的人。试着完善下面这句话:"我觉得我的项目能够帮助到 A,或者那些尝试做 B 事情的人。"不要只是简单地宣传,更需要学会倾听和回复别人的反馈。
通常,你应该先想着帮助别人而不是获取回报。因为在网上宣传一个项目对任何人来说都很简单,所以肯定会有很多人在做同样的事情。告诉人们你是谁,而不是你想要什么,这样才能从众多宣传者中脱颖而出。
diff --git a/_articles/zh-hans/leadership-and-governance.md b/_articles/zh-hans/leadership-and-governance.md
index 52b25bd0e3a..78edb21c7be 100644
--- a/_articles/zh-hans/leadership-and-governance.md
+++ b/_articles/zh-hans/leadership-and-governance.md
@@ -59,7 +59,7 @@ redirect_from: /zh-cn/leadership-and-governance/
对于稍大型点的项目,如果你已经拥有了网页的话,那么请创建一个团队的页面,或者创建一个团队领导的页面。举例来说, [PostgreSQL](https://github.com/postgres/postgres/) 就拥有一个[很全面的团队页面](https://www.postgresql.org/community/contributors/) ,而且每位贡献者都拥有简短的介绍。
-如果你的项目拥有非常活跃的贡献者社区,你或许会专门建立一个维护者的“核心团队”,甚至是根据不同的话题所有者成立子的委员会(例如,安全,问题筛选,或者是社区准则)。让人们自行组织、且能够让志愿者自行找到自己喜欢的角色,而不是去分配他们。
+如果你的项目拥有非常活跃的贡献者社区,你或许会专门建立一个维护者的"核心团队",甚至是根据不同的话题所有者成立子的委员会(例如,安全,问题筛选,或者是社区准则)。让人们自行组织、且能够让志愿者自行找到自己喜欢的角色,而不是去分配他们。
\[我们\] 为核心团队设立多个"子团队"。每个子团队都会专门的聚焦于某个特定的领域,举例来说,语言设计或程序库(...) 为了确保全局的协调和健壮,会将整体的项目设置为同一个愿景,每个子团队是由核心团队的一员。
@@ -98,9 +98,9 @@ redirect_from: /zh-cn/leadership-and-governance/
关于开源项目有三类通用的相关治理结构。
-* **BDFL:** BDFL 是 “终身仁慈独裁者” 的缩写. 在此结构下,有一个人(通常是项目的最初的作者)拥有项目中所有的最后决定权。[Python](https://github.com/python) 就是一个非常经典的例子。较小的项目可能默认就是 BDFL 结构,因为他一般就是一到两位维护者。若是公司组织的项目也极有可能会采用BDFL结构。
+* **BDFL:** BDFL 是 "终身仁慈独裁者" 的缩写. 在此结构下,有一个人(通常是项目的最初的作者)拥有项目中所有的最后决定权。[Python](https://github.com/python) 就是一个非常经典的例子。较小的项目可能默认就是 BDFL 结构,因为他一般就是一到两位维护者。若是公司组织的项目也极有可能会采用BDFL结构。
-* **精英制:** **(注: 术语 "精英制" 对于一些社群可能具有消极的含义,其拥有较[复杂的社会和政治的历史](http://geekfeminism.wikia.com/wiki/Meritocracy).)** 在精英制下,活跃的项目贡献者(他们用行动证明自己是“精英”)给一个正式的决策作用,决定通常会基于纯粹的投票一致性。精英制的概念首次由[Apache Foundation](https://www.apache.org/)提出;[所有的Apache 项目](https://www.apache.org/index.html#projects-list) 都是基于精英制的。贡献者只能代表自己是独立的个体,不可以是公司。
+* **精英制:** **(注: 术语 "精英制" 对于一些社群可能具有消极的含义,其拥有较[复杂的社会和政治的历史](http://geekfeminism.wikia.com/wiki/Meritocracy).)** 在精英制下,活跃的项目贡献者(他们用行动证明自己是"精英")给一个正式的决策作用,决定通常会基于纯粹的投票一致性。精英制的概念首次由[Apache Foundation](https://www.apache.org/)提出;[所有的Apache 项目](https://www.apache.org/index.html#projects-list) 都是基于精英制的。贡献者只能代表自己是独立的个体,不可以是公司。
* **自由贡献:** 在自由贡献的模式下,做最多工作的人通常被认为是最具影响力的,但是是基于当前的工作,而不是历史的贡献。项目的重大决策是基于寻求共识的过程(对不同的声音要讨论)而不是纯粹的投票,尽可能的努力的去囊括多的社区观点。较流行的使用自由贡献模式的项目有[Node.js](https://foundation.nodejs.org/) 和 [Rust](https://www.rust-lang.org/)。
@@ -134,7 +134,7 @@ redirect_from: /zh-cn/leadership-and-governance/
将商业的活动视为正常不过的事情很重要,它也只是代码的开发方法之一。为开发者付费不应该被特殊的对待,好像代码必须是无偿开发的才行;每个贡献都必须有技术的衡量标准来进行评估。人们应该在这些商业的活动中感到非常的自在,而且针对特定的增强或功能项讨论时也应是坦荡的、自然的。
-“商业” 是完全和“开源”相容的。“商业”仅仅是意味着某些地方有钱的参与 —— 就是说软件被用于了商业行为,也就是说项目被采用获得了认可。(当开源软件被用于非开源产品的一个部分时,这个整体的产品仍然是"专有的"软件,因为开源,它可以用于商业或非商业的目的。)
+"商业" 是完全和"开源"相容的。"商业"仅仅是意味着某些地方有钱的参与 —— 就是说软件被用于了商业行为,也就是说项目被采用获得了认可。(当开源软件被用于非开源产品的一个部分时,这个整体的产品仍然是"专有的"软件,因为开源,它可以用于商业或非商业的目的。)
和这个世界上很多的其它商业产品一样,商业能够激励开发者去积极的贡献于项目,通过他们靠谱的提交贡献。显而易见的是,一位因花了自己的时间和精力的开发者获得报酬,理应比没有获得报酬的更具持久性,当然,这对于某些圣徒是不成立的,或者这么说吧,报酬是能体现一个贡献度的众多衡量因素的其中之一。所以将你的项目讨论聚焦于贡献上,不要让人们分散精力去思考或做其它的事情。
diff --git a/_articles/zh-hans/starting-a-project.md b/_articles/zh-hans/starting-a-project.md
index 10f30caa539..c121c73f577 100644
--- a/_articles/zh-hans/starting-a-project.md
+++ b/_articles/zh-hans/starting-a-project.md
@@ -15,7 +15,7 @@ redirect_from: /zh-cn/starting-a-project/
如果你正在考虑开始参与开源,那么恭喜你!世界会感激你的贡献。首先我们来谈谈什么是开源以及为什么我们要开源。
-### “开源”是什么意思?
+### "开源"是什么意思?
当一个项目被开源,这意味着**任何人都可以出于任何目的查看,使用,修改和分发你的项目**。 这些权限通过[开源许可](https://opensource.org/licenses)强制实施。
@@ -50,13 +50,13 @@ redirect_from: /zh-cn/starting-a-project/
开源并不仅仅限于软件。您可以开源任何事物,从数据集到书本。查看 [GitHub Explore](https://github.com/explore) 来找找有什么是你可以开源的。
-### 开源是指“免费”吗?
+### 开源是指"免费"吗?
-开源最大的吸引之一是它不花钱。 但是,“免费”只是开源的总体价值的一小部分。
+开源最大的吸引之一是它不花钱。 但是,"免费"只是开源的总体价值的一小部分。
因为[开源许可证要求](https://opensource.org/osd-annotated)任何人可以几乎出于任何目的使用,修改和共享您的项目,项目本身往往是免费的。 如果该项目花钱使用,任何人也都可以合法地复制和使用免费版本。
-因此,大多数开源项目是免费的,但“免费”不是开源定义的一部分。 有些方法可以通过双重许可或有限功能间接地为开源项目收费,同时仍然遵守开源的官方定义。
+因此,大多数开源项目是免费的,但"免费"不是开源定义的一部分。 有些方法可以通过双重许可或有限功能间接地为开源项目收费,同时仍然遵守开源的官方定义。
## 我应该开始自己的开源项目吗?
@@ -255,7 +255,7 @@ redirect_from: /zh-cn/starting-a-project/
-使用热情,通俗易懂的语言(如“他们”,即使是指一个人)能够让新来的贡献者感觉项目非常欢迎他们。使用简单的语言,因为你的读者可能英语不是很好。
+使用热情,通俗易懂的语言(如"他们",即使是指一个人)能够让新来的贡献者感觉项目非常欢迎他们。使用简单的语言,因为你的读者可能英语不是很好。
除了书写风格外,你的编码风格也是你项目品牌的一部分。 [Angular](https://github.com/johnpapa/angular-styleguide) 和 [jQuery](https://contribute.jquery.org/style-guide/js/)是两个项目代码风格严谨的示例和指南。
From 4f76991aeaedb753dfe0951d49d0f176db42e5ce Mon Sep 17 00:00:00 2001
From: OctagonalStar <76486554+OctagonalStar@users.noreply.github.com>
Date: Sat, 22 Nov 2025 10:34:18 +0800
Subject: [PATCH 4/4] docs(_articles/zh-hans/getting-paid): correct bracket
Signed-off-by: OctagonalStar <76486554+OctagonalStar@users.noreply.github.com>
---
_articles/zh-hans/getting-paid.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/_articles/zh-hans/getting-paid.md b/_articles/zh-hans/getting-paid.md
index 21770ece1fe..81803ba7cb9 100644
--- a/_articles/zh-hans/getting-paid.md
+++ b/_articles/zh-hans/getting-paid.md
@@ -17,7 +17,7 @@ redirect_from: /zh-cn/getting-paid/
-我尝试着寻找让人爱不释手的编程项目,从而使我的周末或圣诞节也能保持状态。(...)我拥有一台家用电脑,手头也并不十分宽裕。在思考了一阵子之后,我决定写一新的交互式的编程语言,(...)后来我将这门语言叫做Python。
+我尝试着寻找让人爱不释手的编程项目,从而使我的周末或圣诞节也能保持状态。(...)我拥有一台家用电脑,手头也并不十分宽裕。在思考了一阵子之后,我决定写一新的交互式的编程语言,(...)后来我将这门语言叫做Python。
— @gvanrossum, ["Python 编程"](https://www.python.org/doc/essays/foreword/)