Eclipse开源政策系列 – 19 – 初始贡献

原文参考：

http://wiki.eclipse.org/Development_Resources/Initial_Contribution

背景

在你可以提交一个初始贡献之前，需要先配置你的项目。在该过程中，将会为你的项目分配一个代码库、访问下载服务器的权限等。你和其他的开发者也会拥有提交者权限；只有提交者可以把代码写入代码库。但是在你写入代码库之前，你的第一次贡献（“初始贡献”）必须要经过Eclipse的IP团队的审查。

在你开始之前，请先确保熟悉你的顶级项目章程，并且贡献需要与该章程的范围以及项目中定义的范围一致。你应该与项目的领导、父项目（如果有的话）的领导以及PMC讨论贡献的性质。你的PMC需要对你的贡献进行审批；贡献的社会化机制将会使工作流程更加顺畅。

对于Eclipse基金会中孵化项目的贡献可以充分利用并行知识产权（IP）流程。根据并行IP流程，IP团队会对贡献执行一个初步的扫描，并且——基于他们的初始发现——授权该代码的提交。当收到该授权以后，项目的提交者可以将该贡献提交至代码库并开始项目编码工作。项目通常可以很快通过并行IP检查并得以提交。具体时间取决于IP团队当前工作队列的深度，但审批应该会在几天内完成。

在发布版本的IP尽职调查未完成之前，项目不能发布该版本。

尽职调查可能需要一段时间，尤其是对于贡献者众多的大代码库，每个贡献者都需要被验证并且有可能被拒掉。几乎可以肯定将会有一些需要解决的代码问题。对于类似“我从XXX偷|解放了这个过来”这样的注释几乎都需要进行研究。另外还会有需要梳理的第三方依赖库。不幸的是，很难量化“一段时间”是多久，因为它依赖于很多因素。对于已建立多年的代码库，在多个开发者经过了若干年的开发之后，IP尽职调查可能需要数月才能完成。即使是小规模的代码审查也可能需要花费几天或几周。

请确保你熟悉Eclipse的尽职调查过程。如果有任何问题，请咨询你的PMC或项目导师。

提交初始贡献

准备你的初始贡献

1. 等待来自为你的项目预分配的网站管理员（Webmaster）的通知。

2. 确保你的贡献中的命名空间与Eclipse命名规则保持一致（例如，eclipse.<项目名称>.*）。

a) 所有的bundle和package的名字必须符合既定规范；

b) 一定要重命名嵌入在代码中的扩展点id和bundle id。

3. 确保Eclipse版权和许可声明已按正确的形式包含在了源文件中，如果可行还需包括在配置文件之中（注意，Eclipse项目的版权工具可以协助你制作版权声明）。

4. 请确保有必要的声明：

a) about.html，许可文件等；

b) 确保在贡献的内容中没有嵌套的jar或者zip文件。

提交你的初始贡献

1. 访问项目的“PMI”页面（例如MDM@Web），并点击“Committer Tools”区域的“创建一个贡献调查表（Create a Contribution Questionnaire）”来打开一个“贡献调查表（Contribution Questionnaire ，CQ”）。

○ 这将会在我们的IPZilla系统中为你的贡献创建一条记录；

○ 在记录创建以后IPZilla将会通过电子邮件通知你；

2. 在收到IPZilla发来的通知以后，打开该记录并附加上包含你的初始贡献的存档。

请注意，在CQ附件中不允许包含嵌套的jar文件或者zip文件。该项目中使用的所有第三方依赖库都需要有单独的CQ（遵循如上所述的同样的“提交”过程）。

请你自行熟悉Eclipse第三方依赖政策和流程（Eclipse Policy and Procedures for Third Party Dependencies）。如果你不确定相关内容，则请询问你的PMC、项目导师或EMO来获得帮助。

更多信息请参见新提交者手册（The New Committer Handbook）。