You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@seata.apache.org by ji...@apache.org on 2025/07/06 10:46:10 UTC

(incubator-seata-website) branch docusaurus updated: add new committer page (#991)

This is an automated email from the ASF dual-hosted git repository.

jimin pushed a commit to branch docusaurus
in repository https://gitbox.apache.org/repos/asf/incubator-seata-website.git


The following commit(s) were added to refs/heads/docusaurus by this push:
     new ff93836291a add new committer page (#991)
ff93836291a is described below

commit ff93836291ac40dafb5b2cee0974b8863dbd4cfb
Author: jimin <sl...@163.com>
AuthorDate: Sun Jul 6 18:46:06 2025 +0800

    add new committer page (#991)
    
    Signed-off-by: slievrly <sl...@163.com>
---
 .../committer-guide/new-committer_dev.md           |  1 +
 .../committer-guide/new-committer_dev.md           | 72 +++++++++++++++++++++
 .../committer-guide/new-committer_dev.md           | 73 ++++++++++++++++++++++
 .../current/developers/team/team.md                |  6 +-
 sidebars.js                                        |  1 +
 5 files changed, 150 insertions(+), 3 deletions(-)

diff --git a/docs/developers/committer-guide/new-committer_dev.md b/docs/developers/committer-guide/new-committer_dev.md
new file mode 100644
index 00000000000..8f9293a8d53
--- /dev/null
+++ b/docs/developers/committer-guide/new-committer_dev.md
@@ -0,0 +1 @@
+Placeholder. DO NOT DELETE.
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/developers/committer-guide/new-committer_dev.md b/i18n/en/docusaurus-plugin-content-docs/current/developers/committer-guide/new-committer_dev.md
new file mode 100644
index 00000000000..34564fa6c3e
--- /dev/null
+++ b/i18n/en/docusaurus-plugin-content-docs/current/developers/committer-guide/new-committer_dev.md
@@ -0,0 +1,72 @@
+# New Committer Guide
+
+This document primarily serves as a guide for new committers to Apache Seata.
+
+Upon receiving an invitation email from Seata PMC, a new committer should consider whether accepting.
+If they decide in favor, they should select "Reply All" and express their decision.
+
+## Submit CLA
+
+1. Download the ICLA from https://www.apache.org/licenses/contributor-agreements.html#clas. If a corporation assigns employees to work on an Apache project, please download the CCLA.
+2. Complete the ICLA based on your particulars. Please note:
+  - The address field should be filled out accurately and in detail.
+  - You need to choose a unique ApacheID that hasn't been taken. Check https://people.apache.org/committer-index.html to see which IDs are still available.
+3. Sign the document by hand or by electronic signature
+  - Manually sign a printed copy, then scan it to produce a pdf.
+  - Digitally draw a signature on the document: [Detail Instruction](https://www.apache.org/licenses/cla-faq.html#printer).
+  - Sign the document using PGP: [Detail Instruction](https://www.apache.org/licenses/contributor-agreements.html#submitting).
+4. Send your icla.pdf (and icla.pdf.asc if PGP-signed) to [secretary@apache.org](mailto:secretary@apache.org).
+
+After waiting for some time, you will receive an email notifying you that your CLA has been successfully recorded.
+
+## Setup ASF Account
+
+When receiving an email with the subject "Welcome to the Apache Software Foundation" from root@apache.org, we can begin setting up an ASF account.
+
+### Setup LDAP Password
+
+1. Go to https://id.apache.org/reset/enter and enter your ApacheID.
+2. Check your email and click the provided link to reset your password.
+
+### Link ASF Account to GitHub
+
+1. Navigate to https://gitbox.apache.org/boxer/ and enter your ApacheID and password.
+2. Click "Authenticate with GitHub" 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 https://gitbox.apache.org/boxer/. Congrats on successfully linking your ASF account to GitHub!
+
+## Email Settings
+
+Note: Apache does not provide a mailbox directly.
+
+### Receive Email
+
+You can change your forwarding email address at [Apache Account Utility Platform](https://id.apache.org/)
+
+### Send Email
+
+To send emails using your apache.org address, configure your email client to leverage the `mail-relay` service. For specifics, refer to [this guide](https://infra.apache.org/committer-email.html).
+
+Here's an illustration for Gmail users:
+
+1. Open Gmail settings and select "See all settings".
+2. Navigate to "Accounts and Import", then locate "Send mail as".
+3. Click "Add another email address" and enter your name and apache.org email address.
+4. Input the SMTP server information:
+  - SMTP Server: mail-relay.apache.org
+  - Port: 587
+  - Username: your apacheID
+  - Password: your apacheID password
+  - Secured connection using TLS
+5. Click "Add account" and you will receive an email from Gmail that need to confirm.
+
+### Subscribe to Mailing List
+
+1. Send email to [dev-subscribe@seata.apache.org](mailto:dev-subscribe@seata.apache.org)
+2. You will receive an email with the subject "confirm subscribe to dev@seata.apache.org"
+3. Reply to the email with "Confirm" in the body
+
+If you receive an email with the subject "WELCOME to dev@seata.apache.org", you have successfully subscribed to the mailing list.
diff --git a/i18n/zh-cn/docusaurus-plugin-content-docs/current/developers/committer-guide/new-committer_dev.md b/i18n/zh-cn/docusaurus-plugin-content-docs/current/developers/committer-guide/new-committer_dev.md
new file mode 100644
index 00000000000..963eaacb7a5
--- /dev/null
+++ b/i18n/zh-cn/docusaurus-plugin-content-docs/current/developers/committer-guide/new-committer_dev.md
@@ -0,0 +1,73 @@
+# 新提交者指南
+
+本文档主要为指导新晋提交者(committer)加入 Apache Seata 社区。
+
+当收到来自 Seata PMC 的邀请邮件后,新提交者应先仔细考虑是否接受。 若决定接受,请点击“全部回复”并明确表达同意意愿。
+
+## 提交 CLA
+
+1. 从 https://www.apache.org/licenses/contributor-agreements.html#clas 下载ICLA。若企业指派员工参与Apache项目,请下载CCLA。
+2. 根据个人情况填写ICLA。
+  注意:
+  - 地址栏需填写详细准确信息。
+  - 需选择未被占用的唯一ApacheID,可通过 https://people.apache.org/committer-index.html 查询可用ID。
+3. 签署协议(可选择手写签名或电子签名):
+  - 打印文档手写签名后扫描为PDF。
+  - 电子签名绘制指引: [详细指引](https://www.apache.org/licenses/cla-faq.html#printer).
+  - 使用PGP签名指引: [详细指引](https://www.apache.org/licenses/contributor-agreements.html#submitting).
+4. 将签署后的icla.pdf(如使用PGP签名需附带icla.pdf.asc)发送至 [secretary@apache.org](mailto:secretary@apache.org).
+
+等待数日后,您将收到CLA归档成功的确认邮件。
+
+## 配置 ASF 账户
+
+
+当收到来自 root@apache.org,标题为"Welcome to the Apache Software Foundation"的邮件后,即可开始配置ASF账户。
+
+### 设置LDAP密码
+
+1. 访问 https://id.apache.org/reset/enter 输入ApacheID。
+2. 查收邮件并点击重置链接设置密码。
+
+### 绑定GitHub账户
+
+1. 访问 https://gitbox.apache.org/boxer/ 输入ApacheID及密码。
+2. 点击"Authenticate with GitHub"按指引完成GitHub授权绑定。
+3. 查收标题为"[GitHub] @asfgit has invited you to join the @apache organization"的邮件并接受邀请。
+4. 稍等片刻页面将自动刷新。
+5. 若GitHub未启用双因素认证,请按照 [指引](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication).
+
+此时 https://gitbox.apache.org/boxer/ 将显示您的ApacheID与GitHub账户绑定状态,恭喜绑定成功!
+
+## 邮件配置
+
+注:Apache不直接提供邮箱服务。
+
+### 接收邮件
+
+可通过 [Apache Account Utility Platform](https://id.apache.org/) 修改邮件转发地址。
+
+### 发送邮件
+
+如需使用apache.org邮箱发信,需在邮件客户端配置mail-relay服务,详见 [指南](https://infra.apache.org/committer-email.html).
+
+以Gmail为例:
+
+1. 进入Gmail设置 → 查看所有设置。
+2. 选择"账号和导入" → 找到"用这个地址发送邮件"。
+3. 点击"添加其他邮箱地址",输入姓名及apache.org邮箱地址。
+4. 填写SMTP信息:
+  - SMTP 服务器: mail-relay.apache.org
+  - 端口: 587
+  - 用户名: your apacheID
+  - 密码: your apacheID password
+  - TLS加密
+5. 点击"添加账号"后查收验证邮件完成配置。
+
+### 订阅邮件组
+
+1. 发送邮件至 [dev-subscribe@seata.apache.org](mailto:dev-subscribe@seata.apache.org)
+2. 查收主题为"confirm subscribe to dev@seata.apache.org" 的确认邮件。
+3. 回复确认邮件。
+
+当收到主题为 "WELCOME to dev@seata.apache.org" 的邮件,即表示订阅成功。
diff --git a/i18n/zh-cn/docusaurus-plugin-content-docs/current/developers/team/team.md b/i18n/zh-cn/docusaurus-plugin-content-docs/current/developers/team/team.md
index b385d0bca04..9245b8df130 100644
--- a/i18n/zh-cn/docusaurus-plugin-content-docs/current/developers/team/team.md
+++ b/i18n/zh-cn/docusaurus-plugin-content-docs/current/developers/team/team.md
@@ -3,11 +3,11 @@ title: Team
 keywords: [Seata]
 description: Team.
 ---
-# Team
+# 团队
 我们衷心感谢所有贡献者,感谢你们的奉献精神、专业知识和宝贵的努力,推动这个社区驱动的项目。你们对于社区的成功起到了重要作用。
 
-## PPMC members and Committers
+## PPMC 成员和提交者
 committers 列表查看 [此处](https://people.apache.org/phonebook.html?podling=seata)。
 
-## Contributors
+## 贡献者
 The contributor 列表可以从每个 GitHub repo 的 contributor 页面查阅。
diff --git a/sidebars.js b/sidebars.js
index 40c73b7f1af..eeaf9d581c5 100644
--- a/sidebars.js
+++ b/sidebars.js
@@ -228,6 +228,7 @@ const sidebars = {
       label: 'Committer Guide',
       collapsible: false,
       items: [
+        'developers/committer-guide/new-committer_dev',
         'developers/committer-guide/label-an-issue-guide_dev',
         'developers/committer-guide/website-guide_dev'
       ],


---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@seata.apache.org
For additional commands, e-mail: notifications-help@seata.apache.org