diff --git a/apache/incubator/cookbook-zh.md b/apache/incubator/cookbook-zh.md index 1d3c8de..b25a0a9 100644 --- a/apache/incubator/cookbook-zh.md +++ b/apache/incubator/cookbook-zh.md @@ -9,7 +9,7 @@ [三、与孵化器沟通](三、与孵化器沟通) -[四、寻找接口人和导师](四、寻找接口人和导师) +[四、寻找领路人和导师](四、寻找领路人和导师) [五、创建孵化提案](五、创建孵化提案) @@ -92,19 +92,19 @@ ASF非常重视“社区重于代码”（Community Over Code）这一理念，A 可以通过公开链接：[general@incubator.a.o](https://lists.apache.org/list.html?general@incubator.apache.org)访问邮件列表，与孵化器PMC进行沟通。 -## 四、寻找接口人和导师 +## 四、寻找领路人和导师 -为了进入孵化器，您的项目需要一名接口人和至少2-3名导师。这些人需要是孵化器PMC中的成员，ASF成员只需提出即可加入孵化器PMC。 +为了进入孵化器，您的项目需要一名领路人（只有Apache officer或member可以做领路人）和至少2-3名导师。这些人还需要是孵化器PMC中的成员，ASF成员只需提出即可加入孵化器PMC。（孵化过程涉及的各角色及其职责请参见[Roles and Responsibilities](http://incubator.apache.org/guides/roles_and_responsibilities.html)） -接口人负责在创建提案过程中帮助孵化项目，他们在前面的步骤中（至少直到项目提案被接收）充当孵化项目与孵化器PMC之间的联络员，之后可能会继续担任导师。 +领路人负责在创建提案过程中帮助孵化项目，他们在前面的步骤中（至少直到项目提案被接收）充当孵化项目与孵化器PMC之间的联络员，之后可能会继续担任导师。 导师则会在项目成长为顶级项目的道路上全程陪伴。 -起点通常是寻找接口人，您可以在[general@incubator.a.o](https://lists.apache.org/list.html?general@incubator.apache.org)邮件列表中提交项目的简短介绍，附上相关链接，并说明您正在寻找接口人，努力引起大家的兴趣。如果您认识任何ASF成员或孵化导师，可以直接询问他们是否愿意提供帮助。 +起点通常是寻找领路人，您可以在[general@incubator.a.o](https://lists.apache.org/list.html?general@incubator.apache.org)邮件列表中提交项目的简短介绍，附上相关链接，并说明您正在寻找领路人，努力引起大家的兴趣。如果您认识任何ASF成员或孵化导师，可以直接询问他们是否愿意提供帮助。 ## 五、创建孵化提案 -接口人会帮助项目准备孵化提案，提案会对新项目进行描述，以便后续与孵化器PMC进行初步讨论。 +领路人会帮助项目准备孵化提案，提案会对新项目进行描述，以便后续与孵化器PMC进行初步讨论。 提案需要包含若干标准段落，详情请参考[podling proposal template](https://cwiki.apache.org/confluence/display/INCUBATOR/New+Podling+Proposal). @@ -130,7 +130,7 @@ ASF项目的孵化提案都保存在[Incubator wiki](https://cwiki.apache.org/co ## 七、孵化提案投票 -讨论阶段一结束，接口人或项目代表就会在[general@incubator.a.o](https://lists.apache.org/list.html?general@incubator.apache.org)邮件列表中创建[VOTE]帖子。 +讨论阶段一结束，领路人或项目代表就会在[general@incubator.a.o](https://lists.apache.org/list.html?general@incubator.apache.org)邮件列表中创建[VOTE]帖子。 投票过程依据[ASF投票规则](https://www.apache.org/foundation/voting)进行。简言之，投票发生在孵化器邮件列表中，持续至少72小时，由孵化器PMC成员进行投票，遵循多数投票法，也欢迎其他人进行投票。 @@ -138,7 +138,7 @@ ASF项目的孵化提案都保存在[Incubator wiki](https://cwiki.apache.org/co 孵化器PMC投票决定创建该项目后，就可以为其配置基础设施。 -通常，接口人或孵化导师会推动这一过程。但是，如果项目社区成员知道如何进行操作的话，也可以由社区成员推动这一过程。 +通常，领路人或孵化导师会推动这一过程。但是，如果项目社区成员知道如何进行操作的话，也可以由社区成员推动这一过程。 详情请参考[Infra and the Incubator](https://infra.apache.org/infra-incubator.html)。 @@ -241,19 +241,19 @@ ASF社区发展PMC（Community Development PMC）维护的[成熟度模型](http 步骤 | 内容 | 详情 -- | -- | -- 1 | 与孵化器沟通 | 孵化器PMC管理孵化器，帮助项目孵化。 -2 | 寻找领路人（champion）和孵化导师，讨论并准备孵化方案 | 项目要进入孵化器，需要一个接口人和至少2-3个导师，只有孵化器PMC中的成员可以担任这两种角色。 -3 | 创建孵化方案 | 接口人会帮助项目准备孵化方案，该方案将用于下一步与孵化器PMC的讨论。方案可以根据模板编写，需要包含几个标准部分。 -4 | 与孵化器PMC讨论孵化方案 | 方案准备好后，项目代表要将其发送至general@incubator.a.o邮箱，孵化器PMC会对该方案进行讨论。 -5 | 如有需要，完善方案中初始提交者和导师列表 | - -6 | 如有需要，基于孵化器PMC的反馈完善方案 | - -7 | 孵化器PMC对方案进行投票 | 讨论阶段结束后，接口人或项目代表会在general@incubator.a.o邮件列表中启动【投票】进程，投票按照ASF的投票规则进行。 -8 | 设置该项目的基础设施（JIRA等） | 如果孵化器PMC同意接受该项目，就可建立该项目的基础设施了，该过程通常由接口人或导师进行推动，如果社区成员熟悉该操作，也可由社区成员来推动。 -9 | 导入初始代码 | 企业捐赠的项目，在导入初始代码前，需要提交软件授权协议（SGA）或企业贡献者许可协议（CCLA）；个人捐赠的项目，在导入初始代码前，需要主要贡献者提交个人贡献者许可协议（ICLA）或SGA。导入过程中，需要检查和报告代码中受美国出口管制法管制的密码技术。除此以外，代码还需要按照Apache模板，进行清理和重新打包。 -10 | 围绕该项目的代码构建社区 | 包括投票产生新的提交者和PPMC成员（Podling Project Management Committee）。 -11 | 发布项目，记录并完善发布过程 | 在孵化期间，预计将发布多个版本，这些版本将逐渐符合ASF发布政策。完全合规的发布是项目毕业的条件之一。孵化中的项目进行发布还必须在任何发布文件名中包含“incubating”一词，并根据孵化器发布指南包含免责声明或免责声明-WIP，以防止对项目状态产生任何混淆。由于孵化中的项目还不是“真正的”ASF项目，所以设定正确的期望值是很重要的。 孵化中的项目版本发布需要两次投票，一次是在开发者邮件列表上进行的投票，如果PPMC成员中至少有3个赞成票（+1），并且赞成票比反对票（-1）多就算通过了。第二次是在孵化器常规邮件列表上进行的投票，这次投票由孵化器PMC进行投票。 Apache发布仅包含源代码，但是项目通常也会分发一些编译过的软件包。软件源代码发布是发布重点，所有分发的编译过的软件包均基于这些发布的“正式”的源代码。 -12 | 准备毕业，与导师一起评估项目的准备情况 | 准备毕业的项目需要根据ASF提供的成熟度模型进行自我评估，这可以帮助发现在孵化过程中被忽略的事务。 +2 | 寻找领路人（champion）和孵化导师，讨论并准备孵化提案 | 项目要进入孵化器，需要一个领路人（Apache officer或member）和至少2-3个导师(IPMC member)（孵化过程涉及的各角色及其职责请参见[Roles and Responsibilities](http://incubator.apache.org/guides/roles_and_responsibilities.html)）。 +3 | 创建孵化提案 | 领路人会帮助项目准备孵化提案，该提案将用于下一步与孵化器PMC的讨论。提案可以根据模板编写，需要包含几个标准部分。 +4 | 与孵化器PMC讨论孵化提案 | 提案准备好后，项目代表要将其发送至[general@incubator.a.o](https://lists.apache.org/list.html?general@incubator.apache.org)邮件列表，孵化器PMC会对该方案进行讨论。 +5 | 如有需要，完善提案中初始提交者和导师列表 | - +6 | 如有需要，基于孵化器PMC的反馈完善提案 | - +7 | 孵化器PMC对提案进行投票 | 讨论阶段结束后，领路人或项目代表会在[general@incubator.a.o](https://lists.apache.org/list.html?general@incubator.apache.org)邮件列表中创建【投票】帖，投票按照ASF的投票规则进行。 +8 | 配置该项目的基础设施（JIRA等） | 如果孵化器PMC同意接受该项目，就可建立该项目的基础设施了，该过程通常由领路人或导师进行推动，如果社区成员熟悉该操作，也可由社区成员来推动。 +9 | 导入初始代码 | 企业捐赠的项目，在导入初始代码前，需要提交软件授权协议（SGA）或企业贡献者许可协议（CCLA）；个人捐赠的项目，在导入初始代码前，需要主要贡献者提交个人贡献者许可协议（ICLA）或SGA。导入过程中，需要检查和报告代码中受美国出口管制法管制的密码技术。除此以外，代码以及二进制发行版还需要按照Apache License合规要求，进行清理。 +10 | 围绕该项目代码构建社区 | 包括投票产生新的提交者和PPMC成员（Podling Project Management Committee）。 +11 | 发布项目，记录并完善发布过程 | 在孵化期间，预计将发布多个版本，这些版本将逐渐符合ASF发布政策。 **完全合规的发布是项目毕业的条件之一。** 孵化中的项目进行发布还必须在任何发布文件名中包含“incubating”一词，并根据孵化器发布指南包含免责声明或免责声明-WIP，以防止对项目状态产生任何混淆。由于孵化中的项目还不是“真正的”ASF项目，所以设定正确的期望值是很重要的。 孵化中的项目版本发布需要两次投票，一次是在开发者邮件列表上进行的投票，如果PPMC成员中至少有3个赞成票（+1），并且赞成票比反对票（-1）多就算通过了。第二次是在孵化器常规邮件列表上进行的投票，这次投票由孵化器PMC进行投票。 Apache发布仅包含源代码，但是项目通常也会分发一些编译过的软件包。软件源代码发布是发布重点，所有分发的编译过的软件包均基于这些发布的“正式”的源代码。 +12 | 准备毕业，与导师一起评估项目的就绪情况 | 准备毕业的项目需要根据ASF提供的[成熟度模型](https://community.apache.org/apache-way/apache-project-maturity-model.html)进行自我评估，这可以帮助发现在孵化过程中被忽略的事务。 13 | 将商标转让给ASF | 将代码捐赠给ASF的企业或个人，如果持有该项目需要的商标，则需在项目毕业前，将商标转让给ASF。 -14 | 与孵化器PMC讨论毕业 | 如果社区和导师根据自我评估认为项目已经做好准备，可以毕业，会在孵化器常规邮件列表上开始一个【讨论】进程，提议毕业并请求孵化器PMC审查该项目。 -15 | 孵化器PMC进行毕业投票 | 毕业提议的【讨论】进程结束后，孵化器常规邮件列表上会开始一个【投票】进程，孵化器PMC对该项目进行投票，投票依据ASF投票规则进行。 -16 | ASF董事会决议 | 孵化器投票通过后，将会创建董事会决议进程并发送给ASF董事会，供董事会投票。董事会每月第三个周三会召开会议，会上会对此类决议进行投票，投票结果即刻生效。 -17 | 毕业后的任务 | 毕业后，项目需要在孵化器状态页面上更新状态，并对其资源和流程进行一些更改。 +14 | 与孵化器PMC讨论毕业 | 项目毕业需要PPMC先进行投票以达成共识，如果社区和导师根据自我评估认为项目已经做好准备，可以毕业，会在孵化器常规邮件列表上创建一个【讨论】帖，提议毕业并请求孵化器PMC审查该项目。 +15 | 孵化器PMC进行毕业投票 | 毕业提议的【讨论】进程结束后，导师或PPMC成员会在孵化器常规邮件列表上创建一个【投票】贴，孵化器PMC对该项目进行投票，投票依据ASF投票规则进行。 +16 | ASF董事会决议 | 孵化器投票通过后，将会创建董事会决议的帖子并发送给ASF董事会，供董事会投票。董事会每月第三个周三会召开会议，会上会对此类决议进行投票，投票结果即刻生效。 +17 | 毕业后的任务 | 毕业后，项目需要在孵化器状态页面上更新状态，并对其资源和流程进行一些更改。项目毕业后，将由新组建的PMC定期向董事会进行报告，最初三个月每月一次，之后是每季度一次。毕业后的项目如果发展停滞，将进入Attic，即归档退休。关于项目毕业后资源转移的步骤及Attic的详细内容，之后会一一奉上，敬请期待。