Apache Incubator 入门与规范手册
面向参与者(Candidate 提交人、贡献者 Contributor、潜在 Committer)的 Apache Incubator 入门手册——如何订阅邮件列表、如何准备并提交提案、如何以贡献者身份参与 Podling 社区、如何晋升为 Committer,以及需遵循的 Apache Way 行为规范
Apache Incubator 入门与规范手册
本文从参与者视角出发,告诉你作为一个希望把项目带到 Apache、或希望以普通贡献者身份参与 Apache 孵化项目的个人,怎么上手:如何成为提交人(提案方/Candidate)、如何订阅邮件列表、如何以贡献者身份参与、如何成长为 Committer,以及需要遵守的 Apache Way 行为规范。依据 incubator.apache.org 官方资料撰写。
一、概述/背景
Apache Incubator 是所有想进入 Apache 软件基金会(ASF)的新项目(Podling)的入口。作为一个参与者,你可能是:
- 提案方(Candidate/提交人):想把自有开源项目送到 Apache 孵化的人;
- 贡献者(Contributor):希望以个人身份为某个 Podling 贡献代码、文档、测试的人;
- 潜在的 Committer / PPMC 成员:在贡献中持续展现能力后被社区举荐、投票成为提交者的人。
无论哪种身份,都需要先理解 Apache 的协作方式——决策在公开邮件列表上进行、以贡献和能力(merit)而非职位/资历论资格、按 Apache License 开放。
官方入口:
- 主页:https://incubator.apache.org/
- 如何参与:https://incubator.apache.org/howtoparticipate.html
- 参与者指南(Roles/Participation):https://incubator.apache.org/guides/participation.html
二、如何成为提交人(进入孵化流程)
如果你想作为提案方把项目带到 Apache,请对照下列步骤。
2.1 先做功课
- 阅读 Cookbook,判断 ASF 是否适合你的项目;
- 阅读 Incubation Policy 了解参与规则;
- 阅读 The Apache Way,理解社区第一、精英治理等核心理念;
- 订阅 general@incubator.apache.org 学会列表讨论文化,并浏览归档(https://lists.apache.org/list.html?general@incubator.apache.org)。
2.2 找 Champion 与确定 Sponsor
- 作为 Candidate,你必须有一位 Champion(ASF 的 Officer 或 Member),他会帮助你完成初始提交、识别风险、物色 Mentor 并推动进入孵化的投票。
- 确定 Sponsor(某个 TLP 或 IPMC),多数情况下与 Champion 商定以 IPMC 为赞助方,走向 TLP。
2.3 撰写并发布提案
- 按 Proposal Guide 起草,可在 Incubator Wiki 模板 上协作迭代。
- 以
[PROPOSAL]前缀为主题,把最终稿以纯文本发布到 general 列表,随后进入公开讨论,定稿后发起 VOTE。
2.4 作为提交人的入门 Checklist
| 检查项 | 官方依据 |
|---|---|
| 已订阅 general 列表 | https://incubator.apache.org/guides/lists.html |
| 已有 Champion | Candidate 必需 |
| 已确定 Sponsor | Proposal 阶段必需 |
| 已发布 [PROPOSAL] 邮件 | Proposal Guide |
| 已通过接收投票并成为 Podling | Incubation Policy |
三、如何以贡献者(Contributor)身份参与
即使你不提交自己的项目,也完全可以作为贡献者参与某个正在孵化的 Podling。
3.1 找到感兴趣的项目
- 浏览当前 Podling 清单:https://incubator.apache.org/projects/#current —— 每个项目的状态页会列出项目描述、Sponsor、Mentor、PPMC 成员、邮件列表与版本库链接。
- 通过每个 Podling 的 dev 列表 / user 列表 与社区互动。
3.2 从哪里入手贡献
| 贡献类型 | 说明 |
|---|---|
| 代码(patch / PR) | 通过项目公开仓库提交,熟悉项目贡献指南(CONTRIBUTING) |
| 文档、翻译、示例 | 很多项目文档工作量大,是好的切入点 |
| 测试与缺陷报告 | 在项目的 Jira(issues.apache.org 下对应项目键)提交 issue |
| 回答问题 / 帮助用户 | 在 user 列表上帮助解答,积累 merit |
3.3 参与注意点
- 一切决策公开可见:技术讨论、设计取舍都在 dev 列表上进行,尊重"公开异步、留有归档"的文化。
- 以能力与持续贡献建立声望:Apache 是 meritocracy,晋升基于实际贡献而非资历。
- 礼貌、就事论事:项目会在邮件列表上追求开放、积极、包容的氛围;分歧针对技术而非个人。
3.4 Contributor 参与 Checklist
| 检查项 | 说明 |
|---|---|
| 已订阅目标 Podling 的 dev/user 列表 | 是 |
| 已阅读项目贡献与协议说明 | 遵循项目文档 |
| 已从低门槛任务切入(文档/Bug) | 是 |
| 已遵守 CLA 等合规要求 | 需要时签署 ICLA |
四、如何成长为 Committer
成为 Committer 标志着社区对你持续贡献的认可。这是孵化环节的常态主题,也是项目的多元性与健康度的重要体现。
4.1 晋升路径
Apache 没有统一的硬性考试,通行路径是:
- 持续在 dev 列表贡献代码/文档/Review;
- 维护积极、专业的社区形象;
- 由现有 Committer/PPMC 成员提名;
- 社区在项目 dev 列表发起 VOTE,通过后授予提交权限(详见治理规范文档的投票章节)。
4.2 项目对 Committer 的期待
孵化中的 Podling 希望其 Committer(依据 Roles and Responsibilities):
- 熟悉 ASF Committer 开发信息;
- 让 Mentor 了解进展(在项目邮件列表公开开展业务是关键途径,"no news is bad news");
- 主动招募新 Committer,保持社区活力与多元;
- 让决策过程公开可见、可问责;
- 朝"像其他 Apache 项目一样遵循 ASF 政策"运作;
- 建立并维护新 Committer 引入流程文档。
4.3 晋升 Committer Checklist
| 检查项 | 说明 |
|---|---|
| 已有持续公开贡献记录 | 是 |
| 已熟悉 ASF 提交者规范 | developer info |
| 已被现有成员提名并发起 VOTE | 是 |
| VOTE 通过并开出账号/权限 | git、Jira、roster 等 |
五、Apache Way 行为与合规规范
无论哪种身份,都需要遵循 Apache 的协作与合规底线。
5.1 协作规范(The Apache Way)
| 原则 | 含义 |
|---|---|
| 社区优先于代码 | 健康社区比单一代码产出更受重视 |
| 精英治理(Meritocracy) | 影响力来自实际贡献与能力 |
| 公开透明 | 决策在开放的邮件列表上异步进行并留档 |
| 尊重与包容 | 就技术分岐、不对人身攻击 |
| 宽松商业友好许可 | 默认 Apache License(ASL 2.0) |
5.2 合规底线
- 免责声明:Podling 网站/文档/发布物必须带有"处于孵化"的 DISCLAIMER 文本(标准或 DISCLAIMER-WIP 两种选一),模板见 Incubation Policy。
- CLAs:贡献者可能需要签署 ASF 的贡献者许可协议(ICLA,Individual Contributor License Agreement;已有代码贡献企业管理层掌握),通过 Mentor 与 ASF 秘书对接,参见 https://www.apache.org/licenses/#clas 。
- 商标:项目名与产品名须遵循名称/品牌规则,避免侵犯他方商标,见 https://www.apache.org/foundation/marks/naming.html 。
5.3 沟通规范速查
| 场景 | 做法 |
|---|---|
| 阅读归档 | 新成员先看列表归档再提问,避免重复 |
| 发起讨论 | 用清晰的 Subject,公开发到相应列表 |
| 发起投票 | 按 ASF Voting Process,用 [VOTE] 前缀并注明投票议题与截止 |
| 发布公告 | 孵化中发布前先确认免責声明与品牌合规 |
六、结语
Apache Incubator 对参与者是开放的:无论你带来一个项目,还是以贡献者身份加入某个 Podling,只要遵循 Apache Way——公开讨论、凭贡献论资格、尊重他人、合规清晰——就能逐步从 Contributor 成长为 Committer,乃至参与 PPMC 治理。整套参与规范可结合《Apache Incubator 项目管理与治理规范》与《Apache Incubator 孵化中项目清单与操作指南》一起阅读。
七、官方参考链接
- Apache Incubator 主页:https://incubator.apache.org/
- 如何参与:https://incubator.apache.org/howtoparticipate.html
- Proposal Guide:https://incubator.apache.org/guides/proposal.html
- Roles and Responsibilities:https://incubator.apache.org/guides/roles_and_responsibilities.html
- 邮件列表指南:https://incubator.apache.org/guides/lists.html
- ASF 提交者信息:https://www.apache.org/dev/
- CLA 说明:https://www.apache.org/licenses/#clas
- 名称/品牌规则:https://www.apache.org/foundation/marks/naming.html
- 投票规则:https://www.apache.org/foundation/voting.html