|
|
Line 1: |
Line 1: |
− | __FORCETOC__
| + | This page's content has been moved to the [https://www.eclipse.org/projects/handbook/#release Eclipse Project Handbook]. |
− | =Overview=
| + | |
− | [[Image:ReleaseCycle.png|center]]
| + | |
− | | + | |
− | # A release starts with planning.
| + | |
− | #* Create a [[Project Management Infrastructure/Project Metadata#Releases|release record]] at the beginning of the release cycle.
| + | |
− | #** You can create as many future release records as you'd like.
| + | |
− | #* Capture the [[Development Resources/Project Plan|project plan]] directly in the release record using the PMI.
| + | |
− | #* The plan doesn't need to be particularly detailed, but it does need to exist.
| + | |
− | #* The plan should lay out in broad terms what the goals are for the release.
| + | |
− | #** Set a date. The date can change.
| + | |
− | #** Provide a concise (i.e. one paragraph, no bullets) description for the release.
| + | |
− | #** Capture at least one theme for the release (this could be as simple as "Fix bugs")
| + | |
− | #* The plan can change during the release cycle (please inform your project's community when you change the plan)
| + | |
− | # Implement functionality
| + | |
− | #* Ensure that all committers are aware of the [http://www.eclipse.org/legal/EclipseLegalProcessPoster.pdf Eclipse IP Due Diligence Process] and [http://www.eclipse.org/projects/dev_process/development_process.php Eclipse Development Process]
| + | |
− | #** All significant contributions by non-committers, and third-party libraries used by the project code must be tracked and approved by the IP Team (see [[Development Resources/Contribution Questionnaire|Contribution Questionnaires]])
| + | |
− | #* Ensure that intellectual property contributions are being tracked
| + | |
− | #** See [[Development Resources/Handling Git Contributions|Handling Git/Gerrit contributions]]
| + | |
− | # Produce milestone
| + | |
− | #* Generate regular builds of the project and host them on your project's download site
| + | |
− | # Release
| + | |
− | #* For all major/minor releases, you must engage in a [[#Release_Review|release review]]
| + | |
− | #** Release reviews are not required for bug-fix/service releases
| + | |
− | #* All of your project's intellectual property contributions ([[Development Resources/Contribution Questionnaire|contribution questionnaires]]) must be approved by the IP Team before you can release (this includes third-party libraries and contributions of code to be maintained by the project).
| + | |
− | #* Send a note to [mailto:emo@eclipse.org EMO] to request a release review
| + | |
− | #* When the release review has been declared successful by the EMO, generate your final build (or rename a previous RC/M build) and host them on your project's download site
| + | |
− | | + | |
− | =Release Review=
| + | |
− | | + | |
− | Release reviews run for a week and always conclude on a Wednesday. We normally schedule no more than two review periods each month (generally the first and third Wednesday).
| + | |
− | | + | |
− | [[Image:ReleaseReview.png|center]]
| + | |
− | | + | |
− | # Assemble review documentation
| + | |
− | #* Concise documentation is appreciated by everybody
| + | |
− | #* Capture the review information directly in the [[Project Management Infrastructure/Release Metadata|release record]].
| + | |
− | #** Alternatively, you can provide a separate document (e.g. PowerPoint presentation) if you must
| + | |
− | #* You can assemble this during the release cycle (there's no need to wait until the end)
| + | |
− | # Assemble the IP Log
| + | |
− | #* [[Development Resources/IP Log|IP Logs]] are [[Development Resources/Automatic IP Log|generated automatically]] using project data.
| + | |
− | #** If you consistently follow the IP Policy, then assembling the IP Log should require no dedicated effort.
| + | |
− | #* [[Development Resources/Contribution Questionnaire|Contribution questionnaire]] data is harvested directly from IPZilla.
| + | |
− | #* Contribution information is harvested directly from the project's source code repositories.
| + | |
− | #* The information used to generate an IP Log should always be up-to-date (don't wait until the end of the release cycle to make it right).
| + | |
− | #* Use the [http://www.eclipse.org/projects/tools/downloads.php Project Downloads Scanner Tool] to confirm that your project downloads contain only approved third-party code
| + | |
− | #** This tool was designed to scan OSGi bundles; it may not produce good results for standard Java JARs or builds based on other programming languages. | + | |
− | #** The tool displays the output from a service that runs daily; new additions to your project's download directory may take as much as 24 hours to appear.
| + | |
− | #* Use the [http://www.eclipse.org/projects/tools/ip_contribution_review.php Bugzilla Contribution Review Tool] to identify Bugzilla records that may contain IP that needs to be tracked. Projects that use Git and follow the guidelines for [http://wiki.eclipse.org/Development_Resources/Handling_Git_Contributions handling Git contributions] will not get much value out of this tool.
| + | |
− | # Submit the IP Log
| + | |
− | #* All of your project's intellectual property contributions ([[Development Resources/Contribution Questionnaire|contribution questionnaires]]) must be approved by the IP Team before you can release
| + | |
− | #* Do this at least one week in advance of the start of the review period
| + | |
− | #* The IP Log Generator has a "submit" button. Click it.
| + | |
− | #* The EMO will perform a technical assessment of the log content; be prepared to answer questions.
| + | |
− | #* Following the technical assessment, the IP team will do their assessment.
| + | |
− | #* The IP team will notify you of IP Log approval.
| + | |
− | # PMC Review
| + | |
− | #* Send an email to your PMC via their public mailing list to request approval of the review documentation
| + | |
− | #* One week in advance of the start of the review period may be a little excessive; most PMCs can turn this around in short order. Still, it's good to give them some advance notice and time to complete the task.
| + | |
− | #** The requirements for approval varies from PMC-to-PMC, but for most PMCs, a single +1 is all you need.
| + | |
− | #* Send a note to [mailto:emo@eclipse.org EMO] with a link to the mailing list discussion showing PMC approval.
| + | |
− | # Start the release review
| + | |
− | #* A review will be scheduled when the following is received by the EMO:
| + | |
− | #** Proof of PMC approval of the review documentation; and
| + | |
− | #** Approval of the IP Log from the IP Team.
| + | |
− | #* The EMO will schedule review and announce it to the community.
| + | |
− | # End Release Review
| + | |
− | #* Release reviews end on Wednesdays (generally late morning in the eastern time zone).
| + | |
− | #* Wait for an approval notice
| + | |
− | # Publish your release
| + | |
− | #* Generate your final release bits.
| + | |
− | #* Tell the world.
| + | |
− | | + | |
− | Please see more detailed information about [[Development Resources/HOWTO/Release Reviews|Release Reviews]], including the [[Development Resources/HOWTO/Release Reviews#Checklist|checklist]].
| + | |
− | | + | |
− | <hr/>
| + | |
− | This page is moderated by the EMO.
| + | |
− | | + | |
− | [[Category:Eclipse Development Process]]
| + | |