Skip to content

Commit

Permalink
[Improve] Localization Contribution Guide (#263)
Browse files Browse the repository at this point in the history
  • Loading branch information
VampireAchao authored Oct 3, 2023
1 parent 24b1a95 commit fc4e550
Show file tree
Hide file tree
Showing 5 changed files with 708 additions and 0 deletions.
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
---
id: 'become_committer'
title: '成为Committer'
sidebar_position: 2
---

<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
https://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->


## 成为 Apache StreamPark 的 Committer

任何支持社区并在 CoPDoC 领域中工作的人都可以成为 Apache StreamPark 的Committer。CoPDoC 是 ASF 的缩写,用来描述我们如何不仅仅通过代码来认识到您的贡献。

- **Co**mmunity(社区) - 你可以通过我们的邮件列表、问题追踪器、讨论页面与社区成员互动,并分享愿景和知识。
- **P**roject(项目) - 需要明确的愿景和共识。
- **Do**cumentation(文档) - 没有它,内容只会停留在作者的头脑中。
- **C**ode(代码) - 没有代码,讨论就毫无意义。

Apache StreamPark 社区努力追求基于功绩的原则。因此,一旦有人在 CoPDoC 的任何领域有了足够的贡献,他们就可以成为 Committer 的候选人,最终被投票选为 StreamPark 的 Committer。成为 Apache StreamPark 的 Committer 并不一定意味着你必须使用你的提交权限向代码库提交代码;它意味着你致力于 StreamPark 项目并为我们社区的成功做出了积极的贡献。

## Committer 的要求:

没有成为 Committer 或 PPMC 成员的严格规则。新的 Committer 的候选人通常是积极的贡献者和社区成员。但是,如果能稍微明确一些规则,就可以在一定程度上消除贡献者的疑虑,使社区更加透明、合理和公平。

### 持续的贡献

Committer 的候选人应该持续参与并为 StreamPark 做出大量的贡献(例如修复漏洞、添加新功能、编写文档、维护问题板、代码审查或回答社区问题),无论是向主网站的代码库还是 StreamPark 的 GitHub 仓库贡献。

- +3 个月的轻度活动和参与。
- +2 个月的中度活动和参与。
- +1 个月的高度活动和参与。

### 贡献的质量
- 对项目有深入的理解。
- 经过充分测试、良好设计、遵循 Apache StreamPark 的编码标准,及简单的修复补丁。
- 井井有条的面向用户的详细文档。

### 社区参与

- 在开发邮件列表上保持积极、礼貌与尊重,并帮助指导新的贡献者和用户。
- 在项目维护的问题跟踪器上积极、有礼貌与尊重。
- 对于拉取请求审查保持积极、有礼貌与尊重。
- 即使存在分歧,也要以专业和外交的态度参与技术路线图的讨论。
- 通过撰写文章或举办活动来推广项目。
Original file line number Diff line number Diff line change
@@ -0,0 +1,58 @@
---
id: 'become_pmc_member'
title: '成为PMC member'
sidebar_position: 3
---

<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
https://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->

## 成为 Apache StreamPark 的 PMC 成员

任何支持社区并在 CoPDoC 领域中工作的人都可以成为 Apache StreamPark 的PMC 成员。CoPDoC 是 ASF 的缩写,用来描述我们如何不仅仅通过代码来认识到您的贡献。

- **Co**mmunity(社区) - 您可以通过我们的邮件列表、问题追踪器、讨论页面与社区成员互动,并分享愿景和知识。
- **P**roject(项目) - 需要明确的愿景和共识。
- **Do**cumentation(文档) - 没有它,内容只会停留在作者的头脑中。
- **C**ode(代码) - 没有代码,讨论就毫无意义。

Apache StreamPark 社区努力追求基于功绩的原则。因此,一旦有人在 CoPDoC 的任何领域有了足够的贡献,他们就可以成为 PMC 成员资格的候选人,最终被投票选为 StreamPark 的 PMC 成员。成为 Apache StreamPark 的 PMC 成员并不一定意味着您必须使用您的提交权限向代码库提交代码;它意味着您致力于 StreamPark 项目并为我们社区的成功做出了积极的贡献。

## PMC 成员的要求:

没有成为 Committer 或 PPMC 成员的严格规则。新的 PMC 成员的候选人通常是积极的贡献者和社区成员。但是,如果能稍微明确一些规则,就可以在一定程度上消除贡献者的疑虑,使社区更加透明、合理和公平。

### 持续的贡献

PMC 成员的候选人应该持续参与并为 StreamPark 做出大量的贡献(例如修复漏洞、添加新功能、编写文档、维护问题板、代码审查或回答社区问题),无论是向主网站的代码库还是 StreamPark 的 GitHub 仓库贡献。

- +5 个月的轻度活动和参与。
- +4 个月的中度活动和参与。
- +3 个月的高度活动和参与。

### 贡献的质量
- 对项目有深入的理解。
- 经过充分测试、良好设计、遵循 Apache StreamPark 的编码标准,及简单的修复补丁。
- 井井有条的面向用户的详细文档。

### 社区参与

- 在开发邮件列表上保持积极、礼貌与尊重,并帮助指导新的贡献者和用户。
- 在项目维护的问题跟踪器上积极、有礼貌与尊重。
- 对于拉取请求审查保持积极、有礼貌与尊重。
- 即使存在分歧,也要以专业和外交的态度参与技术路线图的讨论。
- 通过撰写文章或举办活动来推广项目。
Original file line number Diff line number Diff line change
@@ -0,0 +1,60 @@
---
id: 'mailing_lists'
title: '邮件列表'
sidebar_position: 1
---

<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
https://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->

StreamPark 开发者邮件列表是您在使用 StreamPark 时提出所有问题的首选方式,它能将您的问题推向整个社区。
这是与社区保持同步的最佳方式。

在您向邮件列表发送任何内容之前,请确保您已经**订阅**了它们。
当前可用的列表在下表中列出。

## 用途

### 开发者列表

- 使用此列表提出您对 StreamPark 的问题
- 由 StreamPark 贡献者用来讨论 StreamPark 的开发

### 提交列表

- 关于 StreamPark 代码库的更改的通知

| 列表名称 | 地址 | 订阅 | 退订 | 归档 |
|---------------------|------------------------------|-------------------------------------------------------------|-----------------------------------------------------------------|-----------------------------------------------------------------------------|
| **开发者列表** | [email protected] | [订阅](mailto:[email protected]) | [退订](mailto:[email protected]) | [归档](https://lists.apache.org/[email protected]) |
| **提交列表** | [email protected] | [订阅](mailto:[email protected]) | [退订](mailto:[email protected]) | [归档](https://lists.apache.org/[email protected]) |

## 订阅步骤

发送订阅邮件也很简单。步骤如下:

- 1、**订阅**:点击上表中的 **订阅** 按钮,它将重定向到您的邮件客户端。主题和内容是任意的。
之后,您会从 [email protected] 收到确认邮件(如果没有收到,请确认电子邮件是否被自动分类为垃圾邮件、推广邮件、订阅邮件等)。
- 2、**确认**:直接回复确认邮件,或点击邮件中的链接快速回复。主题和内容是任意的。
- 3、**欢迎**:在完成上述步骤后,您会收到一个主题为 WELCOME to [email protected] 的欢迎邮件,您已成功订阅 Apache StreamPark 邮件列表。

## 发送纯文本邮件

在发送邮件列表时,请使用纯文本邮件。
**不要使用 HTML 邮件**
HTML 邮件更有可能被视为垃圾邮件并被拒绝。
通过不同的邮件客户端,它可能会出现格式错误,并且其他人不容易阅读。
Loading

0 comments on commit fc4e550

Please sign in to comment.