Apache Incubator 入门与规范手册

面向参与者(Candidate 提交人、贡献者 Contributor、潜在 Committer)的 Apache Incubator 入门手册——如何订阅邮件列表、如何准备并提交提案、如何以贡献者身份参与 Podling 社区、如何晋升为 Committer,以及需遵循的 Apache Way 行为规范

Apache IncubatorApache Incubator2026/10/11

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 开放。

官方入口:

二、如何成为提交人(进入孵化流程)

如果你想作为提案方把项目带到 Apache,请对照下列步骤。

2.1 先做功课

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
已有 ChampionCandidate 必需
已确定 SponsorProposal 阶段必需
已发布 [PROPOSAL] 邮件Proposal Guide
已通过接收投票并成为 PodlingIncubation 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 没有统一的硬性考试,通行路径是:

  1. 持续在 dev 列表贡献代码/文档/Review;
  2. 维护积极、专业的社区形象;
  3. 由现有 Committer/PPMC 成员提名;
  4. 社区在项目 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 孵化中项目清单与操作指南》一起阅读。

七、官方参考链接