Difference between revisions of "Development Resources/Processes"

From Eclipsepedia

Jump to: navigation, search
(Approved)
(Approved)
Line 419: Line 419:
 
==========================
 
==========================
  
Commit the projects approved initial contribution into the projects repository.
+
Commit the projects approved initial contribution into the projects repository. Please
 +
note that history must be collapsed into that single commit.
  
 
+
If you have any questions pertaining to the repository or collapsing the history, please  
If you have any questions pertaining to the repository, please contact the  
+
contact the Webmaster <webmaster@eclipse.org>.
Webmaster <webmaster@eclipse.org>
+
  
  
Line 429: Line 429:
 
================
 
================
  
The Parallel IP process allows the check-in to occur before the legal review
+
The Parallel IP process allows the check-in to occur before the full legal review
is complete (but after the preliminary legal approval). The legal review must
+
is complete (but after preliminary legal approval). The full legal review must
 
be completed before the code is included in a release.
 
be completed before the code is included in a release.
  
Line 467: Line 467:
  
  
Your project mentors are an excellent resource if you need guidance.
+
Your project mentors are an excellent resource if you need guidance. We urge  
We urge you to make use of their expertise.
+
you to make use of their expertise.
  
  

Revision as of 12:49, 17 June 2014

Disclaimer: These are the templated responses we use for email/bugs. This is a work in progress.

Contents

Project Creation

Proposal

Creation Review

Not Scheduled Yet

Next Steps Project Can Do (Work on initial contribution)

Hi Folks,

Your projects creation review has not yet been scheduled.

You can start thinking about and working on getting your initial code
contribution put together. This will help speed up the project on-boarding process.


Next Steps for the Project
==========================

We will schedule the creation review once we have acquired the Trademark and two weeks of community review have passed.


Interim Work The Project Can Do Before Creation Review
======================================================
Couple of items that you can get going on:

- Please have your project leads and committers create Eclipse accounts [1], then log into [2].
This will help speed up the provisioning teams workflow to get all the projects
resources in place quickly.

- Please note, that the email addresses for committers in the proposal must match the email 
addresses associated with the Eclipse account.

- The new project [3] can begin to assemble the projects initial code
contribution [4].

Before you can make an initial contribution, your project needs to be
provisioned. Getting the code ready now will reduce the time to submit the initial
contribution once we've provisioned the project.


Initial Code Contribution
-------------------------

Broadly speaking, the initial code contribution involves:
(this is a quick summary of [4])

- If applicable, update the package namespace. For example
for Java based projects  [5].

- Ensuring Eclipse copyright, license [6] and "about" notices [7].

- Identify all third-party party libraries.


Other items to be aware of with the initial code contribution:

- Code cannot be pushed to the project's source code repository until after
the IP team has approved the initial Contribution.

- The initial contribution must be the first commit in your
project repository. History must be collapsed into that single commit [8].

- Any third-party libraries required by your code will have to be checked and
approved by the IP Team.

- Project-licensed content and third-party-licensed content are not
reviewed together. Separate Contribution Questionnaires (CQ's) [9] are required.


Important: Legal
================

Please familiarize yourself with the IP Due Diligence Process [10] and the
Parallel IP Process [11]. As an incubating project you can take advantage of
Parallel IP to get moving quicker with development.


Project Resources
=================

Please have a look at the Development Resources wiki [12] and [13] the EDP process.



Your project mentors are an excellent resource if you need guidance.
We urge you to make use of their expertise.


Cheers,

Richard


[1] https://dev.eclipse.org/site_login/createaccount.php
[2] https://dev.eclipse.org/site_login/
[3] https://wiki.eclipse.org/Development_Resources/HOWTO/Starting_A_New_Project
[4] http://wiki.eclipse.org/Development_Resources/initial_Contribution
[5] https://wiki.eclipse.org/Development_Resources/HOWTO/The_Eclipse_Code_Namespace_Policy
[6] https://www.eclipse.org/legal/copyrightandlicensenotice.php
[7] https://www.eclipse.org/legal/epl/about.php
[8] https://wiki.eclipse.org/Social_Coding/Hosting_a_Project_at_GitHub#Collapsing_History
[9] https://wiki.eclipse.org/Development_Resources/Contribution_Questionnaire
[10] http://www.eclipse.org/legal/EclipseLegalProcessPoster.pdf
[11] http://www.eclipse.org/projects/dev_process/parallel-ip-process.php
[12] https://wiki.eclipse.org/Development_Resources
[13] https://www.eclipse.org/projects/dev_process/development_process.php

Scheduled

Steps Project Can Do (Work on initial contribution and provide us information for provisioning)

Hi Folks,

Your projects creation review has been scheduled.


Next Steps for the Project
==========================

We will take care of provisioning for you once the project creation review is declared successful.

Make sure that your committers know that they will receive instructions 
regarding required paperwork after the creation review is declared successful.


Information We Need
-------------------

- Please confirm the details of the project proposal section "Source Code".


Interim Work The Project Can Do Before Creation Review
======================================================
Couple of items that you can get going on:

- Please have your project leads and committers create Eclipse accounts [1], then log into [2].
This will help speed up the provisioning teams workflow to get all the projects
resources in place quickly.

- Please note, that the email addresses for committers in the proposal must match the email 
addresses associated with the Eclipse account.

- The new project [3] can begin to assemble the projects initial code
contribution [4].

Before you can make an initial contribution, your project needs to be
provisioned. Getting the code ready now will reduce the time to submit the initial
contribution once we've provisioned the project.


Initial Code Contribution
-------------------------

Broadly speaking, the initial code contribution involves:
(this is a quick summary of [4])

- If applicable, update the package namespace. For example
for Java based projects  [5].

- Ensuring Eclipse copyright, license [6] and "about" notices [7].

- Identify all third-party party libraries.


Other items to be aware of with the initial code contribution:

- Code cannot be pushed to the project's source code repository until after
the IP team has approved the initial Contribution.

- The initial contribution must be the first commit in your
project repository. History must be collapsed into that single commit [8].

- Any third-party libraries required by your code will have to be checked and
approved by the IP Team.

- Project-licensed content and third-party-licensed content are not
reviewed together. Separate Contribution Questionnaires (CQ's) [9] are required.


Important: Legal
================

Please familiarize yourself with the IP Due Diligence Process [10] and the
Parallel IP Process [11]. As an incubating project you can take advantage of
Parallel IP to get moving quicker with development.


Project Resources
=================

Please have a look at the Development Resources wiki [12] and [13] the EDP process.



Your project mentors are an excellent resource if you need guidance.
We urge you to make use of their expertise.


Cheers,

Richard


[1] https://dev.eclipse.org/site_login/createaccount.php
[2] https://dev.eclipse.org/site_login/
[3] https://wiki.eclipse.org/Development_Resources/HOWTO/Starting_A_New_Project
[4] http://wiki.eclipse.org/Development_Resources/initial_Contribution
[5] https://wiki.eclipse.org/Development_Resources/HOWTO/The_Eclipse_Code_Namespace_Policy
[6] https://www.eclipse.org/legal/copyrightandlicensenotice.php
[7] https://www.eclipse.org/legal/epl/about.php
[8] https://wiki.eclipse.org/Social_Coding/Hosting_a_Project_at_GitHub#Collapsing_History
[9] https://wiki.eclipse.org/Development_Resources/Contribution_Questionnaire
[10] http://www.eclipse.org/legal/EclipseLegalProcessPoster.pdf
[11] http://www.eclipse.org/projects/dev_process/parallel-ip-process.php
[12] https://wiki.eclipse.org/Development_Resources
[13] https://www.eclipse.org/projects/dev_process/development_process.php



Provisioning

Requested - Next Steps Project Can Do (Work on initial contribution)

Hi Folks,

We have initiated the provisioning process for your project. 

Please watch your email for information and further instructions. 
This is a multi-step process that requires input from the project 
committers before we can do much else. 

Please complete the committer questionnaire and provide the requested
committer documentation as soon as possible so that we can push forward.


FYI
===

Let your new committers know that they won't be able to fill in their
committer questionnaires until they have received their automated email 
titled "New Committer Request Form."

A "project information" page [1] has been created that you can use to share
information about the project with the community. As your committers are
provisioned, they will be able to edit the information on this page.


Next Steps for the Project
==========================

The next step for the project will be the initial code contribution. While 
you're waiting for provisioning, you can start working on 
the initial contribution.


Initial Code Contribution
-------------------------

Broadly speaking, the initial code contribution involves:
(this is a quick summary of [2])

- If applicable, update the package namespace. For example
for Java based projects  [3].

- Ensuring Eclipse copyright, license [4] and "about" notices [5].

- Identify all third-party party libraries.


Other items to be aware of with the initial code contribution:

- Code cannot be pushed to the project's source code repository until after
the IP team has approved the initial Contribution.

- The initial contribution must be the first commit in your
project repository. History must be collapsed into that single commit [6].

- Any third-party libraries required by your code will have to be checked and
approved by the IP Team.

- Project-licensed content and third-party-licensed content are not
reviewed together. Separate Contribution Questionnaires (CQ's) [7] are required.


Important: Legal
================

Please familiarize yourself with the IP Due Diligence Process [8] and the
Parallel IP Process [9]. As an incubating project you can take advantage of
Parallel IP to get moving quicker with development.


Project Resources
=================

Please have a look at the Development Resources wiki [10] and [11] the EDP process.



Your project mentors are an excellent resource if you need guidance.
We urge you to make use of their expertise.


Cheers,

Richard


[1] /////////// add project pmi page
[2] http://wiki.eclipse.org/Development_Resources/initial_Contribution
[3] https://wiki.eclipse.org/Development_Resources/HOWTO/The_Eclipse_Code_Namespace_Policy
[4] https://www.eclipse.org/legal/copyrightandlicensenotice.php
[5] https://www.eclipse.org/legal/epl/about.php
[6] https://wiki.eclipse.org/Social_Coding/Hosting_a_Project_at_GitHub#Collapsing_History
[7] https://wiki.eclipse.org/Development_Resources/Contribution_Questionnaire
[8] http://www.eclipse.org/legal/EclipseLegalProcessPoster.pdf
[9] http://www.eclipse.org/projects/dev_process/parallel-ip-process.php
[10] https://wiki.eclipse.org/Development_Resources
[11] https://www.eclipse.org/projects/dev_process/development_process.php

Initial Contribution

Submitting IC

Hi Folks,

The project has now been provisioned.


Next Steps for the Project
==========================

The next step for the project will be the initial code contribution.

We use a modified version of Bugzilla that we call IPZilla [1] 
intellectual property contributions for projects. This is only accessible to committers.

Individual contribution records are called Contribution Questionnaire (CQ's) [2] . A CQ 
is required for the projects initial contribution and all third party libraries. 


Broadly speaking, the initial code contribution involves:
(this is a quick summary of [3])

- If applicable, update the package namespace. For example
for Java based projects  [4].

- Ensuring Eclipse copyright, license [5] and "about" notices [6].

- Identify all third-party party libraries.


Other items to be aware of with the initial code contribution:

- Code cannot be pushed to the project's source code repository until after
the IP team has approved the initial Contribution.

- The initial contribution must be the first commit in your
project repository. History must be collapsed into that single commit [7].

- Any third-party libraries required by your code will have to be checked and
approved by the IP Team.

- Project-licensed content and third-party-licensed content are not
reviewed together. Separate Contribution Questionnaires (CQ's) [3] are required.

Important: Legal
================

Please familiarize yourself with the IP Due Diligence Process [8] and the
Parallel IP Process [9]. As an incubating project you can take advantage of
Parallel IP to get moving quicker with development.


Project Resources
=================

Please have a look at the Development Resources wiki [10] and [11] the EDP process.



Your project mentors are an excellent resource if you need guidance. We urge 
you to make use of their expertise.


Thanks and let me know if you have any questions,

Richard


[1] https://wiki.eclipse.org/IPzilla
[2] https://wiki.eclipse.org/Development_Resources/Contribution_Questionnaire
[3] http://wiki.eclipse.org/Development_Resources/Initial_Contribution
[4] https://wiki.eclipse.org/Development_Resources/HOWTO/The_Eclipse_Code_Namespace_Policy
[5] https://www.eclipse.org/legal/copyrightandlicensenotice.php
[6] https://www.eclipse.org/legal/epl/about.php
[7] https://wiki.eclipse.org/Social_Coding/Hosting_a_Project_at_GitHub#Collapsing_History
[8] http://www.eclipse.org/legal/EclipseLegalProcessPoster.pdf
[9] http://www.eclipse.org/projects/dev_process/parallel-ip-process.php
[10] https://wiki.eclipse.org/Development_Resources
[11] https://www.eclipse.org/projects/dev_process/development_process.php

Parallel IP

Approved

Hi Folks,

Your projects has received Parallel-IP checkin approval from the IP Team for
the initial code contribution.


Next Steps for the Project
==========================

Commit the projects approved initial contribution into the projects repository. Please
note that history must be collapsed into that single commit.

If you have any questions pertaining to the repository or collapsing the history, please 
contact the Webmaster <webmaster@eclipse.org>.


Important: Legal
================

The Parallel IP process allows the check-in to occur before the full legal review
is complete (but after preliminary legal approval). The full legal review must
be completed before the code is included in a release.


Accepting Code
==============

The IP Due Diligence Process [1] is an on going process and needs to be followed
closely.


Contributors
------------

Please review [2] on how to handle code submissions.


Committers
----------

FYI [3].


For Projects Hosted on GitHub
-------------------------

Please review hosting a project on GitHub [4] and social coding FAQ's [5].


Project Resources
=================

Please have a look at the Development Resources wiki [6], [7] the EDP process
and Contribution License Agreement (CLA) [8].



Your project mentors are an excellent resource if you need guidance. We urge 
you to make use of their expertise.


Cheers,

Richard


[1] http://www.eclipse.org/legal/EclipseLegalProcessPoster.pdf
[2] https://wiki.eclipse.org/Development_Resources/Contributing_via_Git
[3] https://wiki.eclipse.org/Development_Resources/Handling_Git_Contributions
[4] https://wiki.eclipse.org/Social_Coding/Hosting_a_Project_at_GitHub
[5] https://www.eclipse.org/org/SocialCodingFAQ.php
[6] https://wiki.eclipse.org/Development_Resources
[7] https://www.eclipse.org/projects/dev_process/development_process.php
[8] https://wiki.eclipse.org/CLA

Initial Contribution Approved

Add content

Release Review

Add content

Termination Review

Add content

GitHub Repositories for Projects

Add content

Dual Licensing

Requesting

The //name// project wants to be dual licensed EPL+ //other license//.

//project proposal url//

Dual licensing of an Eclipse project requires approval from the Board of Directors. 

To get approval, we need to make a short presentation [1] (3-4 slides) to the Board that discusses the following:
- why the project needs to be dual licensed. 
- what licenses are you requesting.

Attach the presentation to the bug used to track the dual license request [2].

I would suggest adding a final slide that makes it clear what is the decision being asked of the Board.


Cheers,

Richard


[1] https://wiki.eclipse.org/Development_Resources/HOWTO/Starting_A_New_Project#Licensing
[2] /////// bug url to track dual license request ///////

Granted

The projects dual licensing request has been approved by the Board [1].

The project now needs to update the following files in it's code repository:
- code copyright headers
- about.html
- copyright and license file
- any other notices that are required

Please see [2] for Eclipse Legal resources, in particular [3], [4].


Cheers,

Richard


[1] ////// update with licensing bug ////////
[2] https://www.eclipse.org/legal/
[3] https://www.eclipse.org/legal/epl/about.php
[4] https://www.eclipse.org/legal/copyrightandlicensenotice.php


Accounts

Eclipse Accounts for Proposals

Hi Folks,

Please have your project leads and committers create Eclipse accounts [1], then log into [2].

Please note, that the email addresses for committers in the proposal must match the email addresses associated with the Eclipse account.


Cheers,

Richard


[1] https://dev.eclipse.org/site_login/createaccount.php
[2] https://dev.eclipse.org/site_login