Committer 指南 on Apache Dubbo

Apache 提交者注册流程

Mon, 01 Jan 0001 00:00:00 +0000

一、Apache 提交者的产生

项目孵化初始化提交者

项目孵化阶段，在孵化项目提案中，会有初始化提交者列表这一选项。确认你是初始化提交者的一员。项目在 apache 孵化器社区投票通过后，提交者可以开始准备注册账户了。可以参看孵化器 wiki

活跃的贡献者被选举为提交者

在后期的开发过程中，活跃的贡献者可以被选举为提交者。见如何成为 committer

二、个人开发者提交 ICLA

1、选择 apache id

在 apache 提交者列表页查看已经注册过的 apache id，

2、个人提交者授权协议（ICLA）：

下载 ICLA 模板，查找可用的 id。将 icla.pdf 个人信息填写正确后打印,签名、扫描、并当做附件发送邮件给秘书 secretary@apache.org，秘书会帮忙创建 apache 用户 id。同时会创建一个 your_id@apache.org 的邮箱，可以在 apache 提交者列表页查看查找用户是否已经创建。

3、导师帮助提交用户id创建请求

导师将帮助提交 apache 账户创建请求给 root 邮件组，会有人帮助建立 id。一般需要2天时间账户会建立，请等待并在 apache 提交者列表页查看查找用户是否已经创建。

三、加入apache开发者组

登陆 Apache 账户工具，在登陆页面点击"忘记密码"设置始化密码，会有一封密码重置邮件发送到 forward 邮箱(在孵化项目提案中提交的开发者邮件)
关于 apache 邮箱：apache.org 邮箱并没有自己的邮件内容存储服务器。它需要借用其他邮件提供商的邮件内容存储、分发功能。在很多投票环节是建议使用 apache 邮箱的。这里就有一个问题，怎么在其它邮箱里面配置 apache.org 邮箱转发功能：
- 收件箱：收取发送到 apache.org 的邮件。这个在第一步配置好 Apache 账户工具的 forward 邮箱就可以用 forward 邮箱收取邮件了
- 发件箱：将发出的邮件显示发件邮箱为 apache.org 邮箱。请参考：设置 apache 邮箱指南和 gmail 邮箱设置方式。其他邮箱服务的设置方式不方便找到，gmail 的最方便，建议换成 gmail 邮箱(不是广告)。
修改编辑页面的 homepage url，apache 提交者列表页中你的账户能加主页链接。
修改编辑页面的 github 账户(username)，提交确认后两个小时内会有邮件邀请你加入 github.com/apache-committers 组。这期间可以阅读 ASF 工作方式以对 ASF 开发做一些基本了解。

四、提交者获得对项目的写权限

GitBox 账户链接工具的操作

CLA 签署向导

Mon, 01 Jan 0001 00:00:00 +0000

以下情况，需要您签署 Apache ICLA：

在 Dubbo 被捐赠给 Apache 之前，您已经为 Dubbo 作出了很多贡献，并且您以前没有签署过 Alibaba-CLA。
您已经为 Dubbo 作出了很多贡献，并且您被邀请成为 Dubbo 提交者，且之前没有签署过 Alibaba-CLA 或者 Apache ICLA。

步骤

下载这篇 pdf 文档
编辑该文档，在必要的空格处填上适当的内容
打印
在打印好的文件上签字
扫描
发送一封邮件到secretary@apache.org，并抄送给private@dubbo.apache.org：
- 邮件标题为 “ICLA submission”
- 请在邮件正文附上您的github账号链接
- 请记得将您的 ICLA 文档放入邮件的附件里

空格填写必要说明

Mailing address：首选英文格式的公司地址
Preferred apache id(s)：如果您被邀请成为一名提交者，那么需要您填写一个apache账号，否则，可以不填
Notify project：Dubbo（意思就是Dubbo就是通知您签署ICLA的项目）

网站向导

Mon, 01 Jan 0001 00:00:00 +0000

Apache Dubbo 的网站仓库是 https://github.com/apache/dubbo-website
网站构建完毕后，它会被自动发布到 dubbo.apache.org，您也可以通过 https://selfserve.apache.org 手动触发（需要使用 Apache 账号登陆）

给问题打标签

Mon, 01 Jan 0001 00:00:00 +0000

如果您正在处理一个问题，请记得给这个问题标记一个或者多个您认为有意义的标签。有了标签，其他开发人员就会很轻松地识别出问题，以便对其进行分类并跟踪进度。

对于需要编码和发版修复的 issues 和 pull requests，需要您将其标记为 milestone。

一些常用的标签：

请求帮助
- help wanted
- good first issue
优先级
- priority/blocker
- priority/high
- priority/low
- priority/normal
状态
- status/need-triage
- status/DO-NOT-MERGE
- status/READY-TO-MERGE
- status/invalid
- status/wontfix
类型
- type/bug
- type/documentation
- type/enhancement
- type/feature

官方 Dubbo 主页的维护

Mon, 01 Jan 0001 00:00:00 +0000

Apache 有一个官方的网站，用来维护所有的孵化项目的信息。每一个孵化项目在这个网站下都有一个信息页。 Dubbo 的信息页地址是 https://incubator.apache.org/projects/dubbo.html。

当项目发生比较大的变化，比如新的 committer 的加入，新的 PMC 的当选，或是新版本的 Release 等，都需要将这些更新信息维护到这个页面。

这个官方网站的项目地址是https://svn.apache.org/repos/asf/incubator/public/trunk。

维护这个页面的方法如下：

1.安装 SVN。若是 Mac OS X 系统或是 Linux 系统，则自带了 SVN。若是 Windows 系统，则请首先自行安装 SVN。

2.用 SVN 将这个项目 checkout 下来。

3.修改 content/projects/dubbo.xml 文件，并保存。

4.安装 ANT。执行 trunk 目录下的 build.sh 或者 build.bat 脚本构建项目。

5.构建完成后，可以用浏览器打开 target/site/projects/dubbo.html 文件，预览修改是否生效。

6.用 SVN 的 commit 命令将 dubbo.xml 文件提交到服务器，并且不要提交 dubbo.html 文件（因为服务器端会定时自动构建）。此过程会要求输入Apache id和密码。

参考: