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)。

打赏一下
支付宝
微信
除非注明,博客文章均为原创,转载请标明文章地址
本文地址: http://www.javafxchina.net/blog/2016/04/eclipse-policy-19-initial-contribution/
百度未收录