Skip to content

Commit

Permalink
Update cookbook-zh.md
Browse files Browse the repository at this point in the history
  • Loading branch information
jnjt115 authored and WillemJiang committed Jan 19, 2021
1 parent 08d04ac commit 9b6af1e
Showing 1 changed file with 68 additions and 30 deletions.
98 changes: 68 additions & 30 deletions apache/incubator/cookbook-zh.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,14 +2,52 @@
原文地址: https://incubator.apache.org/cookbook/
## 译文版
# Apache孵化器指南
## 目录
[一、我们的项目适合Apache孵化器吗?](一、我们的项目适合Apache孵化器吗?)

[二、成为ASF顶级项目的步骤是什么?](二、成为ASF顶级项目的步骤是什么?)

[三、与孵化器沟通](三、与孵化器沟通)

[四、寻找接口人和导师](四、寻找接口人和导师)

[五、创建孵化提案](五、创建孵化提案)

[六、讨论孵化提案](六、讨论孵化提案)

[七、孵化提案投票](七、孵化提案投票)

[八、配置基础设施](八、配置基础设施)

[九、宣传和公告](九、宣传和公告)

[十、导入初始代码](十、导入初始代码)

[十一、社区构建](十一、社区构建)

[十二、项目发布](十二、项目发布)

[十三、关于项目版本发布的两轮投票](十三、关于项目版本发布的两轮投票)

[十四、孵化项目与顶级项目的区别是什么?](十四、孵化项目与顶级项目的区别是什么?)

[十五、毕业就绪评估](十五、毕业就绪评估)

[十六、毕业讨论](十六、毕业讨论)

[十七、将商标转让给ASF](十七、将商标转让给ASF)

[十八、毕业投票](十八、毕业投票)

[十九、ASF董事会决议](十九、ASF董事会决议)

[二十、毕业后任务](二十、毕业后任务)

该指南与[孵化器主页](http://incubator.apache.org/)为大家提供了在ASF孵化项目所需的必要信息。该指南汇集了所有孵化器的相关问题,给出了孵化器目标和过程的概述,并提供了更多详细信息的链接。

该指南内容按照项目从被接收孵化到毕业成为顶级项目(Top-Level Project,TLP)的时间顺序进行组织。

## 目录

[TOC]
欢迎大家通过[[email protected]](https://lists.apache.org/[email protected])邮件列表或[INCUBATOR-234](https://issues.apache.org/jira/browse/INCUBATOR-234)任务单对该指南提出反馈意见,也可以向该指南所在的[项目仓库](https://github.com/apache/incubator/tree/master/pages/cookbook)提交补丁。

## 一、我们的项目适合Apache孵化器吗?

Expand All @@ -31,12 +69,12 @@ ASF非常重视“社区重于代码”(Community Over Code)这一理念,A

为此,孵化项目(incoming project,podling)需要执行以下步骤:

- 寻找接口人(champion)和孵化导师(mentor),讨论并准备孵化方案
- 寻找接口人(champion)和孵化导师(mentor),讨论并准备孵化提案
- 决定在ASF孵化;
- 与孵化器PMC讨论方案
- 如果需要,完善方案中的初始提交者和导师列表
- 如果需要,基于孵化器PMC的反馈,完善方案
- 孵化器PMC对方案进行投票
- 与孵化器PMC讨论提案
- 如果需要,完善提案中的初始提交者和导师列表
- 如果需要,基于孵化器PMC的反馈,完善提案
- 孵化器PMC对提案进行投票
- 配置项目的基础设施;
- 围绕项目代码开始构建社区;
- 邀请新的提交者和PPMC成员;
Expand All @@ -52,35 +90,35 @@ ASF非常重视“社区重于代码”(Community Over Code)这一理念,A

孵化器PMC负责管理孵化器,帮助孵化项目完成孵化过程。

可以通过公开链接:https://lists.apache.org/[email protected] [[email protected]]访问邮件列表,与孵化器PMC进行沟通。
可以通过公开链接:[[email protected]](https://lists.apache.org/[email protected])访问邮件列表,与孵化器PMC进行沟通。

## 四、寻找接口人和导师

为了进入孵化器,您的项目需要一名接口人和至少2-3名导师。这些人需要是孵化器PMC中的成员,ASF成员只需提出即可加入孵化器PMC。

接口人负责在创建方案过程中帮助孵化项目,他们在前面的步骤中(至少直到项目方案被接收)充当孵化项目与孵化器PMC之间的联络员,之后可能会继续担任导师。
接口人负责在创建提案过程中帮助孵化项目,他们在前面的步骤中(至少直到项目提案被接收)充当孵化项目与孵化器PMC之间的联络员,之后可能会继续担任导师。

导师则会在项目成长为顶级项目的道路上全程陪伴。

起点通常是寻找接口人,您可以在general@incubator.a.o邮件列表中提交项目的简短介绍,附上相关链接,并说明您正在寻找接口人,努力引起大家的兴趣。如果您认识任何ASF成员或孵化导师,可以直接询问他们是否愿意提供帮助。
起点通常是寻找接口人,您可以在[general@incubator.a.o](https://lists.apache.org/[email protected])邮件列表中提交项目的简短介绍,附上相关链接,并说明您正在寻找接口人,努力引起大家的兴趣。如果您认识任何ASF成员或孵化导师,可以直接询问他们是否愿意提供帮助。

## 五、创建孵化方案
## 五、创建孵化提案

接口人会帮助项目准备孵化方案,方案会对新项目进行描述,以便后续与孵化器PMC进行初步讨论。
接口人会帮助项目准备孵化提案,提案会对新项目进行描述,以便后续与孵化器PMC进行初步讨论。

方案需要包含若干标准段落,详情请参考[podling proposal template](https://cwiki.apache.org/confluence/display/INCUBATOR/New+Podling+Proposal).
提案需要包含若干标准段落,详情请参考[podling proposal template](https://cwiki.apache.org/confluence/display/INCUBATOR/New+Podling+Proposal).

ASF项目的孵化方案都保存在[Incubator wiki](https://cwiki.apache.org/confluence/display/INCUBATOR/Proposals)页面上,可以将它们作为示例进行参考,上一自然段中的链接给出的是方案的最新模板。
ASF项目的孵化提案都保存在[Incubator wiki](https://cwiki.apache.org/confluence/display/INCUBATOR/Proposals)页面上,可以将它们作为示例进行参考,上一自然段中的链接给出的是方案的最新模板。

## 六、讨论孵化方案
## 六、讨论孵化提案

方案准备好后,项目代表需将其发送至general@incubator.a.o进行讨论,主题行应如下,以引起孵化器PMC的注意。
提案准备好后,项目代表需将其发送至[general@incubator.a.o](https://lists.apache.org/[email protected])进行讨论,主题行应如下,以引起孵化器PMC的注意。

`[DISCUSS] Foo Proposal`

该讨论通常会要求方案进行一些改动
该讨论通常会要求提案进行一些改动

该讨论阶段没有规定讨论时长,通常会持续几天,直到所有讨论要点被解决
该讨论阶段没有规定讨论时长,通常会持续几天,直到所有关注问题都被妥善讨论并形成解决方案

以下是最近的讨论,请参考:

Expand All @@ -90,9 +128,9 @@ ASF项目的孵化方案都保存在[Incubator wiki](https://cwiki.apache.org/co
- [TubeMQ proposal](https://lists.apache.org/thread.html/21c5453b40765cf1d5a06540fcf6d76c0d5b6b7df7ade5c29d31aa3e@) (accpeted)
- [MetaObjects proposal](https://lists.apache.org/thread.html/dbdbc6bd8e238d9dbf16604d5fa13500523d6e812fcd863444f99842@) (on hold)

## 七、孵化方案投票
## 七、孵化提案投票

讨论阶段一结束,接口人或项目代表就会在general@incubator.a.o邮件列表中创建[VOTE]进程
讨论阶段一结束,接口人或项目代表就会在[general@incubator.a.o](https://lists.apache.org/[email protected])邮件列表中创建[VOTE]帖子

投票过程依据[ASF投票规则](https://www.apache.org/foundation/voting)进行。简言之,投票发生在孵化器邮件列表中,持续至少72小时,由孵化器PMC成员进行投票,遵循多数投票法,也欢迎其他人进行投票。

Expand Down Expand Up @@ -126,7 +164,7 @@ ASF项目的孵化方案都保存在[Incubator wiki](https://cwiki.apache.org/co

## 十二、项目发布

在项目孵化过程中,我们期待项目可以发布多个软件版本,这些版本会朝着完全符合[ASF发布政策](http://www.apache.org/legal/release-policy.html)的方向逐渐发展。版本发布完全符合ASF发布政策是项目毕业的条件之一。
在项目孵化过程中,我们期待项目可以**发布多个软件版本**,这些版本会朝着完全符合[ASF发布政策](http://www.apache.org/legal/release-policy.html)的方向逐渐发展。版本发布完全符合ASF发布政策是项目毕业的条件之一。

按照[孵化器发布指南](https://incubator.apache.org/guides/releasemanagement.html#choice_of_disclaimers)要求,项目发布版本时,任何发布文件名中必须包含“incubating”一词,并且必须要包含DISCLAIMER或DISCLAIMER-WIP免责声明,以避免混淆项目状态。由于孵化项目还不是真正的ASF项目,设置适当的期望值很重要。

Expand All @@ -136,9 +174,9 @@ ASF项目的孵化方案都保存在[Incubator wiki](https://cwiki.apache.org/co

项目版本发布的投票分为两个阶段:

首先,在开发人员邮件列表(dev list)上对版本发布进行投票,该轮投票主要是为了让项目社区练习和学习版本发布的投票过程。只要PPMC成员给出至少三张赞成票(+1),并且赞成票多于反对票,就算投票通过。
- 首先,在开发人员邮件列表(dev list)上对版本发布进行投票,该轮投票主要是为了让项目社区练习和学习版本发布的投票过程。只要PPMC成员给出至少三张赞成票(+1),并且赞成票多于反对票(-1),就算投票通过。

如果第一次投票通过,则孵化器PMC在孵化器常规邮件列表上进行第二轮投票,与所有ASF版本发布一样,这是使投票成为基金会行为的规定动作。
- 如果第一次投票通过,则孵化器PMC在孵化器常规邮件列表上进行第二轮投票,与所有ASF版本发布一样,这是使投票成为基金会行为的规定动作。

在孵化器PMC的[VOTE]消息中,需明确将第一轮开发人员邮件列表中的投票情况报告给孵化器PMC,包括投票结果,以及指向项目投票记录的[lists.apache.org](http://lists.apache.org/)链接。这样,导师和其他孵化器PMC成员的投票将与孵化器PMC投票绑定,而不用投两次票。

Expand All @@ -148,7 +186,7 @@ ASF项目的孵化方案都保存在[Incubator wiki](https://cwiki.apache.org/co

顶级项目是成熟的ASF项目,由自己的[PMC](http://www.apache.org/foundation/governance/pmcs)进行管理,并且向[ASF董事会](https://www.apache.org/foundation/board/)进行报告。

孵化项目是正在训练中的顶级项目。他们所做的大部分工作与顶级项目相同,特别是顶级项目在孵化过程中的工作
孵化项目是正在训练中的顶级项目。它们所做的大部分工作与顶级项目相同,特别是它们在孵化过程中的工作

主要的区别如下:

Expand All @@ -159,7 +197,7 @@ ASF项目的孵化方案都保存在[Incubator wiki](https://cwiki.apache.org/co
- 每个顶级项目都有一个[PMC主席](https://apache.org/dev/pmc.html),PMC主席是顶级项目与董事会间的联络人。PMC主席不是项目的领导者,而是一个管理角色,即使他们在ASF组织架构中拥有VP(Vice President)的头衔。孵化项目中没有孵化导师的角色,导师是社区成员中的志愿者,在项目和孵化器PMC间充当联络员。
- 孵化项目的版本发布需要两轮投票。

ASF强烈鼓励项目有规律地成长和更新他们的名单,以促进项目可持续发展。孵化项目和顶级项目都应该留意社区中活跃的成员,积极选拔新的提交者和PMC成员。
ASF强烈鼓励项目有规律地成长,并更新社区的名单(提交者、PMC、PPMC),以促进项目可持续发展。孵化项目和顶级项目都应该留意社区中活跃的成员,积极选拔新的提交者和PMC成员。

## 十五、毕业就绪评估

Expand All @@ -169,23 +207,23 @@ ASF社区发展PMC(Community Development PMC)维护的[成熟度模型](http

## 十六、毕业讨论

基于就绪情况的自评估,当社区和导师认为项目已经准备好毕业了,导师或PPMC成员要在孵化器常规邮件列表中开始一个[DISCUSS]进程,提议毕业并请求孵化器PMC审查项目。
基于就绪情况的自评估,当社区和导师认为项目已经准备好毕业了,导师或PPMC成员要在孵化器常规邮件列表中创建一个[DISCUSS]帖子,提议毕业并请求孵化器PMC审查项目。

讨论中最好包含毕业方案,为接下来的投票做好准备。
讨论中最好包含毕业提案,为接下来的投票做好准备。

## 十七、将商标转让给ASF

捐赠项目给ASF的个人或组织如果持有项目必需的商标,则需在项目毕业前将其转让给ASF。

## 十八、毕业投票

毕业方案讨论结束后,导师或PPMC成员在孵化器常规邮件列表中开始一个[VOTE]进程,孵化器PMC在该进程上对是否向董事会推荐项目进行投票。
毕业提案讨论结束后,导师或PPMC成员在孵化器常规邮件列表中创建一个[VOTE]帖子,孵化器PMC在该进程上对是否向董事会推荐项目进行投票。

该投票遵循标准的[ASF投票规则](https://www.apache.org/foundation/voting),即多数投票法,持续至少72小时,如果重复投票,以最后一次投票为准。

## 十九、ASF董事会决议

一旦孵化器PMC投票通过项目毕业,孵化器PMC(IPMC)将会创建并向ASF董事会发送董事会决议进程,以供董事会进行投票。
一旦孵化器PMC投票通过项目毕业,孵化器PMC(IPMC)将会创建并向ASF董事会发送董事会决议的帖子,以供董事会进行投票。

董事会会在每月的第三个周三召开会议,并在例行会议上对此类决议进行投票。

Expand Down

0 comments on commit 9b6af1e

Please sign in to comment.