This is an automated email from the ASF dual-hosted git repository.
delei pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/fesod.git
The following commit(s) were added to refs/heads/main by this push:
new f9198dce docs: fix typos and refine the content description (#624)
f9198dce is described below
commit f9198dce01cc2722a1ed391d7b110ecb167160b8
Author: DeleiGuo <[email protected]>
AuthorDate: Wed Oct 1 12:15:25 2025 +0800
docs: fix typos and refine the content description (#624)
* docs: refine committer documentation and fix typos
* docs: update ICLA guide with formatting and clarity improvements
* docs: update Apache ID references in onboarding docs
* docs: update committer nomination guide
* docs: refine code review guidelines
* docs: update mailing list subscription link
---
website/community/committer/become-committer.md | 2 +-
website/community/committer/icla.md | 2 +-
website/community/committer/onboarding.md | 6 +++---
.../current/committer/become-committer.md | 10 +++++-----
.../current/committer/icla.md | 10 +++++-----
.../current/committer/onboarding.md | 6 +++---
.../current/contribution/code-review-guide.md | 20 ++++++++++----------
.../current/pmc/nominate-committer.md | 6 +++---
8 files changed, 31 insertions(+), 31 deletions(-)
diff --git a/website/community/committer/become-committer.md
b/website/community/committer/become-committer.md
index ac83d6ce..e5e3ea6e 100644
--- a/website/community/committer/become-committer.md
+++ b/website/community/committer/become-committer.md
@@ -13,7 +13,7 @@ Anyone being supportive of the community and working in any
of the CoPDoC areas
of the authors
- **(C)ode** - discussion goes nowhere without code
-Apache Fesod (Incubating) community strives to be meritocratic. Thus, once
someone has contributed sufficiently to any area of CoPDoC they can be a
candidate for committer-ship and at last voted in as an Apache Fesod
(Incubating) committer. Being an Apache Fesod (Incubating) committer does not
necessarily mean you must commit code with your commit privilege to the
codebase; it means you are committed to the Apache Fesod (Incubating) project
and are productively contributing to our commun [...]
+Apache Fesod (Incubating) community strives to be meritocratic. Thus, once
someone has contributed sufficiently to any area of CoPDoC they can be a
candidate for committer-ship and at last voted in as an Apache Fesod
(Incubating) committer. Being an Apache Fesod (Incubating) committer does not
necessarily mean you must commit code with your commit privilege to the
codebase, it means you are committed to the Apache Fesod (Incubating) project
and are productively contributing to our commun [...]
## Committer requirements
diff --git a/website/community/committer/icla.md
b/website/community/committer/icla.md
index 4905d40b..1c2631f6 100644
--- a/website/community/committer/icla.md
+++ b/website/community/committer/icla.md
@@ -41,7 +41,7 @@ Fill in the following columns in English.
- (optional) preferred Apache id(s)
- You need to choose a unique ApacheID that hasn't been taken. Check [ASF
Committers by ID](https://people.apache.org/committer-index.html) to see which
IDs are still available.
+ You need to choose a unique Apache ID that hasn't been taken. Check [ASF
Committers by ID](https://people.apache.org/committer-index.html) to see which
IDs are still available.
- (optional) notify project:
diff --git a/website/community/committer/onboarding.md
b/website/community/committer/onboarding.md
index 98d42159..9370f6a8 100644
--- a/website/community/committer/onboarding.md
+++ b/website/community/committer/onboarding.md
@@ -17,7 +17,7 @@ We require all contributors to sign a Contributor License
Agreement (CLA). This
## Setup ASF Account
-Go to [Apache Account Utility](https://id.apache.org/reset/enter) and enter
your ApacheID.
+Go to [Apache Account Utility](https://id.apache.org/reset/enter) and enter
your Apache ID.
@@ -27,13 +27,13 @@ After clicking "Send Email", a prompt will appear
indicating that the email has
-1. Navigate to [ASF Boxer](https://gitbox.apache.org/boxer/) and enter your
ApacheID and password.
+1. Navigate to [ASF Boxer](https://gitbox.apache.org/boxer/) and enter your
Apache ID and password.
2. Click "Link GitHub username to ASF id" and follow the given instructions to
link your ASF account to GitHub.
3. Check your email titled "[GitHub] @asfgit has invited you to join the
@apache organization" and accept the invitation.
4. Wait momentarily, and the website will refresh on its own.
5. (If you do not enable 2FA on GitHub) Please follow the
[instruction](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication).
-Your ApacheID and GitHub ID will now both appear on [ASF
Boxer](https://gitbox.apache.org/boxer/). Congrats on successfully linking your
ASF account to GitHub!
+Your Apache ID and GitHub ID will now both appear on [ASF
Boxer](https://gitbox.apache.org/boxer/). Congrats on successfully linking your
ASF account to GitHub!
## Email Settings
diff --git
a/website/i18n/zh-cn/docusaurus-plugin-content-docs-community/current/committer/become-committer.md
b/website/i18n/zh-cn/docusaurus-plugin-content-docs-community/current/committer/become-committer.md
index 8fed04ac..4b1ea675 100644
---
a/website/i18n/zh-cn/docusaurus-plugin-content-docs-community/current/committer/become-committer.md
+++
b/website/i18n/zh-cn/docusaurus-plugin-content-docs-community/current/committer/become-committer.md
@@ -10,7 +10,7 @@ title: '如何成为 Committer'
- **(Do)cumentation** - 没有它，内容只会停留在作者的头脑中。
- **(C)ode** - 没有代码，讨论就毫无意义。
-Apache Fesod (Incubating) 社区努力追求基于功绩的原则。因此，一旦有人在 CoPDoC 的任何领域有了足够的贡献，他们就可以成为
Committer 的候选人，最终被投票选为 Apache Fesod (Incubating) 的 Committer。成为 Apache Fesod
(Incubating) 的 Committer 并不一定意味着你必须使用你的提交权限向代码库提交代码；它意味着你致力于 Apache Fesod
(Incubating) 项目并为我们社区的成功做出了积极的贡献。
+Apache Fesod (Incubating) 社区努力追求基于功绩的原则。因此，一旦有人在 CoPDoC 的任何领域有了足够的贡献，他们就可以成为
Committer 的候选人，最终被投票选为 Apache Fesod (Incubating) 的 Committer。成为 Apache Fesod
(Incubating) 的 Committer 并不一定意味着你必须使用你的提交权限向代码库提交代码，它意味着你致力于 Apache Fesod
(Incubating) 项目并为我们社区的成功做出了积极的贡献。
## Committer 的要求
@@ -37,19 +37,19 @@ Committer 的候选人应该持续参与并为 Apache Fesod (Incubating) 做出
## 日常工作
- 查看社区待处理的 Pull Request 和 Issue 列表，负责问题的处理
- - 包括标记 issue，回复 issue，关闭 issue 等；
+ - 包括标记、回复、关闭 issue 等；
- 将 issue 分配至熟悉该模块的贡献者；
-- Assignee 在被分配 issue 后，需要进行如下判断：
+- 分配 issue 后，需要进行如下判断：
- 判断是否是长期 issue，如是，则标记为 `pending`；
- 判断 issue 类型，如：bug，enhancement，discussion 等；
- 标记 Milestone。
- Committer 提交的 PR，需要根据 PR 类型和当前发布的周期标注 Label 和 Milestone。
-- Committer review PR 时，可以进行 squash and merge to master 的操作，如果有问题可以加上 change
request 或者 @ 相关人员协助处理。
+- Committer 审核通过 PR 时，可以进行 “squash and merge” 的操作，如果有问题可以加上 change request 或者
@ 相关人员协助处理。
## 福利权益
每个 Apache Committer 都有资格获得免费 JetBrains 订阅，使他们能够访问 JetBrains 产品包，如 IntelliJ
IDEA、PyCharm 和其他桌面工具。
-如果您是 Apache ShardingSphere 提交者，但未收到免费的 JetBrains 订阅，请使用您的 @apache.org 电子邮件地址
[All Products Packs for Apache
committers](https://www.jetbrains.com/shop/eform/apache?product=ALL) 以便于 Apache
Fesod (Incubating) 的后续开发。
+如果您已是一名 Apache Committer，但未收到免费的 JetBrains 订阅，请使用您的 @apache.org 电子邮件地址 [All
Products Packs for Apache
committers](https://www.jetbrains.com/shop/eform/apache?product=ALL) 以便于 Apache
Fesod (Incubating) 的后续开发。
如果您已经使用了免费的 JetBrains 订阅，遇到 License 到期，可以使用您的 @apache.org 电子邮件地址
续订免费的所有产品包，并在您的 JetBrains 桌面工具（例如 IntelliJ IDEA） 中点击 `Refresh license list`
刷新订阅。
diff --git
a/website/i18n/zh-cn/docusaurus-plugin-content-docs-community/current/committer/icla.md
b/website/i18n/zh-cn/docusaurus-plugin-content-docs-community/current/committer/icla.md
index 7dfa933a..32ab6c70 100644
---
a/website/i18n/zh-cn/docusaurus-plugin-content-docs-community/current/committer/icla.md
+++
b/website/i18n/zh-cn/docusaurus-plugin-content-docs-community/current/committer/icla.md
@@ -3,13 +3,13 @@ id: 'icla'
title: '签署 ICLA 指南'
---
-Apache CLA 是 Apache贡
献者许可协议的缩写，该协议旨在明确界定向ASF贡献知识产权的条款，从而使我们在未来软件发生法律纠纷时能够为项目提供法律保障。个人在获得任何ASF项目的提交权限前，必须提交经签署的ICLA文件存档。
+Apache CLA 是
Apache贡献者许可协议的缩写，该协议旨在明确界定向ASF贡献知识产权的条款，从而使我们在未来软件发生法律纠纷时能够为项目提供法律保障。个人在获得任何
ASF 项目的提交权限前，必须提交经签署的 ICLA 文件存档。
提交 ICLA 的流程如下：
## 下载模板
-点击链接[贡献者许可协议](https://www.apache.org/licenses/contributor-agreements.html#clas)，在贡献者许可协议部分找到ICLA。
+点击链接[贡献者许可协议](https://www.apache.org/licenses/contributor-agreements.html#clas)，在贡献者许可协议部分找到
ICLA。
@@ -21,15 +21,15 @@ Apache CLA 是 Apache贡 献者许可协议的缩写，该协议旨在明确界
- 全名
- 请填写真实姓名。名字在前，姓氏在后。每个单词的首字母需大写。（注：姓氏与名字之间需留空格，请注意首字母大写，姓氏需置于首位。）
+ 请填写真实姓名。名字在前，姓氏在后。每个单词的首字母需大写。
- 公开名称
- 公开名称应为真实姓名或笔名，不可使用用户ID。
+ 公开名称应为真实姓名或笔名，不能和 Apache ID 重复。
- 邮寄地址
- 英文地址需详细至门牌号。
+ 英文地址，且需详细至门牌号。
- 国家
diff --git
a/website/i18n/zh-cn/docusaurus-plugin-content-docs-community/current/committer/onboarding.md
b/website/i18n/zh-cn/docusaurus-plugin-content-docs-community/current/committer/onboarding.md
index c230d24b..5df5a45a 100644
---
a/website/i18n/zh-cn/docusaurus-plugin-content-docs-community/current/committer/onboarding.md
+++
b/website/i18n/zh-cn/docusaurus-plugin-content-docs-community/current/committer/onboarding.md
@@ -3,7 +3,7 @@ id: 'committer-onboarding'
title: 'Committer 须知'
---
-收到 Apache Fesod (Incubating) PMC 的邀请邮件后，新的 Committer 应考虑是否接受邀请。
+收到 Apache Fesod (Incubating) PPMC 的邀请邮件后，新的 Committer 应考虑是否接受邀请。
若决定接受，请选择 **回复所有** 并表明最终决定。回复邮件请包含以下参考内容：
@@ -33,7 +33,7 @@ Hi, i accept. Thanks for invitaion.
4. 请稍候片刻，网站将自动刷新。
5.
（若您尚未在GitHub启用双重验证）请遵循[操作指南](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication)。
-您的 ApacheID 和 GitHub ID 现已同时显示在 [ASF Boxer](https://gitbox.apache.org/boxer/)
上。恭喜您成功将 ASF 账户与 GitHub 关联！
+您的 Apache ID 和 GitHub ID 现已同时显示在 [ASF Boxer](https://gitbox.apache.org/boxer/)
上。恭喜您成功将 ASF 账户与 GitHub 关联！
## 邮箱设置
@@ -64,7 +64,7 @@ Hi, i accept. Thanks for invitaion.
### 订阅邮件列表
-请参考 [订阅邮件列表](../index.md#how-to-subscribe-to-a-mailing-list)
+请参考 [订阅邮件列表](../index.md#如何订阅邮件列表)
## 在 GitHub 上启用双因素认证
diff --git
a/website/i18n/zh-cn/docusaurus-plugin-content-docs-community/current/contribution/code-review-guide.md
b/website/i18n/zh-cn/docusaurus-plugin-content-docs-community/current/contribution/code-review-guide.md
index 98b574f0..72117c3e 100644
---
a/website/i18n/zh-cn/docusaurus-plugin-content-docs-community/current/contribution/code-review-guide.md
+++
b/website/i18n/zh-cn/docusaurus-plugin-content-docs-community/current/contribution/code-review-guide.md
@@ -3,7 +3,7 @@ id: 'code-review-guide'
title: 'Code Review 指南'
---
-本指南适用于所有希望协助代码贡献评审的提交者和贡献者。感谢您的付出——优质的评审是开源项目中最重要且关键的环节之一。本指南旨在帮助社区实现以下评审目标：
+本指南适用于所有希望协助代码贡献评审的提交者和贡献者。感谢您的付出，优质的评审是开源项目中最重要且关键的环节之一。本指南旨在帮助社区实现以下评审目标：
- 让贡献者获得良好的贡献体验。
- 确保代码审查结构化，全面覆盖贡献的核心要点。
@@ -12,23 +12,23 @@ title: 'Code Review 指南'
## Code Review 指南
-- 始终保持一个较高的标准来进行 review，这样才能更好地保证整个产品的质量。
-- 对于接口类的、整体架构方面的修改，需要在社区进行充分地讨论，可以在邮件组发起，也可以在 issue 上发起。
+- 始终保持一个较高的标准来进行审核，这样才能更好地保证整个产品的质量。
+- 对于接口类的、整体架构方面的修改，需要在社区进行充分地讨论，可以在邮件组发起，也可以在 Issue 上发起。
- 测试覆盖。新增的逻辑需要有对应的测试来覆盖。对于已有老代码，不好增加的可以酌情考虑。
-- 文档。新增加的功能必须要有文档来说明，否则这样的代码不允许合入。必须要有英文文档，最好有中文文档。
-- 代码的可读性。如果 reviewer 对于代码逻辑不是很清晰，那么可以要求 contributor
去解释这段逻辑，并且需要在代码里写充分的注释来解释逻辑。
+- 文档。新增加的功能必须要有文档来说明，否则这样的代码不允许合并。必须要有英文文档，最好有中文文档。
+- 代码的可读性。如果 Reviewer 对于代码逻辑不是很清晰，那么可以要求 Contributor
去解释这段逻辑，并且需要在代码里写充分的注释来解释逻辑。
- 尽量在评论的结尾给出明确的结论。是同意，还是要 change request。如果是小问题，可以只留评论。
-- 如果你已经看过了代码，觉得没有问题，但是觉得需要其他同学来确认下，可以留下 +1 Comment。
+- 如果已经看过了代码，觉得没有问题，但是觉得还需要其他 Reviewer 来确认下，可以留下 +1 Comment。
- 互相尊重，互相学习。在评论的时候保持礼貌的口吻，提建议尽量给出建议的理由。
## PR Review 指南
-- 检查贡献内容是否描述充分，足以支持高质量的评审
+- 检查贡献内容是否描述充分，足以支持高质量的评审。
- Reviewer 需进行代码层级的评审。
- Reviewer 对 PR 发表评论后，需持续跟进该 PR 后续的修改。
-- 一个 PR 至少要获得一个 **非作者外的 Committer +1** 才能允许进行被合入。
-- PR 获得第一个 +1 后，建议等待 **一个工作日** 后才进行合入。主要目的是等待社区其他同学来进行 review。
+- 每个 PR 至少要获得一个 **非作者外的 Committer +1** 才能允许进行被合并。
+- PR 获得第一个 +1 后，建议等待 **一个工作日** 后才进行合并。主要目的是等待社区其他 Reviewer 来进行审核。
- 对于接口类、整体架构方面等被认为是重大变更，则至少要获得 **3 个 +1** 才能进行合并。
- 合并前需确保回归测试与持续集成测试全部通过。
- 合并时请选择“squash and merge”操作。
-- 对于一个修改不同的 reviewer
有争议时，可以尝试讨论解决。如果讨论没有办法解决，可通过`[email protected]`发起邮件投票解决，采取少数服从多数的原则。
+- 不同的 Reviewer 对 PR
有争议时，可以尝试讨论解决。如果讨论无法解决，可通过`[email protected]`发起邮件投票解决，采取少数服从多数的原则。
diff --git
a/website/i18n/zh-cn/docusaurus-plugin-content-docs-community/current/pmc/nominate-committer.md
b/website/i18n/zh-cn/docusaurus-plugin-content-docs-community/current/pmc/nominate-committer.md
index d8fb9337..8e3b30ff 100644
---
a/website/i18n/zh-cn/docusaurus-plugin-content-docs-community/current/pmc/nominate-committer.md
+++
b/website/i18n/zh-cn/docusaurus-plugin-content-docs-community/current/pmc/nominate-committer.md
@@ -51,7 +51,7 @@ Best regards,
${NOMINATOR}
```
-投票将在今天**一周后**结束, 即：
+投票将在今天开始的**一周后**结束, 即：
- [midnight UTC on
YYYY-MM-DD](https://www.timeanddate.com/counters/customcounter.html?year=YYYY&month=MM&day=DD)
- [Apache Voting Guidelines](https://community.apache.org/newcommitter.html)
@@ -172,7 +172,7 @@ establishing you as a committer.
${NOMINATOR} (as represents of The Apache Fesod (Incubating) PPMC)
```
-## 该候选人接受了邀请
+## 候选人接受邀请
如果接受邀请，该候选人将会收到来自 ASF 的一封电子邮件。
@@ -228,7 +228,7 @@ The Apache Fesod (Incubating) PPMC
## 将候选人添加至提交者名单
-候选人接受邀请并完成iCLA记录后，请通过whimsy roster
tools](<https://whimsy.apache.org/roster/committee/fesod)将其添加至提交者名单。>
+候选人接受邀请并完成iCLA记录后，请通过[whimsy roster
tools](https://whimsy.apache.org/roster/committee/fesod)将其添加至提交者名单。
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
