Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "Eclipse/Release checklist"

(One intermediate revision by the same user not shown)
Line 5: Line 5:
 
     <ul>
 
     <ul>
 
       <li>All features should have &quot;(c) Copyright Eclipse contributors and  
 
       <li>All features should have &quot;(c) Copyright Eclipse contributors and  
         others 2000, 2013.&quot; in Help &gt; About Eclipse SDK</li>
+
         others 2000, 2018. All rights reserved.&quot; in Help &gt; About Eclipse SDK</li>
 
       <li>Splash screen copyright needs to be updated</li>
 
       <li>Splash screen copyright needs to be updated</li>
 
     </ul>
 
     </ul>
Line 82: Line 82:
 
     </ul>
 
     </ul>
 
   </li>
 
   </li>
   <li><b>What's New</b> [JohnA]
+
   <li><b>What's New</b>
 
     <ul>
 
     <ul>
 
       <li>Describes the more interesting differences that users will see
 
       <li>Describes the more interesting differences that users will see
Line 94: Line 94:
 
     </ul>
 
     </ul>
 
   </li>
 
   </li>
   <li><b>Submit the IP Log to Eclipse Legal</b> [JohnA]</li>
+
   <li><b>Submit the IP Log to Eclipse Legal</b></li>
 
   <li><b>Eclipse Project Release Notes</b>
 
   <li><b>Eclipse Project Release Notes</b>
 
     <ul>
 
     <ul>
 
       <li>Add known problems for each component and other late-breaking news for
 
       <li>Add known problems for each component and other late-breaking news for
 
         customers of this release</li>
 
         customers of this release</li>
       <li>See [https://bugs.eclipse.org/407766 bug 407766] for details</li>
+
       <li>See [https://bugs.eclipse.org/bugs/show_bug.cgi?id=538337 bug 538337] for details</li>
       <li>Update other sections of readme based on current release plan [JohnA]</li>
+
       <li>Update other sections of readme based on current release plan</li>
 
     </ul>
 
     </ul>
 
   </li>
 
   </li>
 
   <li><b>Acknowledgments</b>
 
   <li><b>Acknowledgments</b>
 
     <ul>
 
     <ul>
       <li>Each component can thank its contributors on the acknowledgments page. See [https://bugs.eclipse.org/409117 bug 409117] for details.</li>
+
       <li>Each component can thank its contributors on the acknowledgments page. See [https://bugs.eclipse.org/bugs/show_bug.cgi?id=538336 bug 538336] for details.</li>
 
     </ul>
 
     </ul>
 
   </li>
 
   </li>
Line 118: Line 118:
 
   </li>
 
   </li>
 
   <li><b>Test the version of PDE build in basebuilder to ensure there aren't any errors</b></li>
 
   <li><b>Test the version of PDE build in basebuilder to ensure there aren't any errors</b></li>
   <li><b>Produce the release review documentation</b> [JohnA]</li>
+
   <li><b>Produce the release review documentation</b></li>
 
</ol>
 
</ol>

Revision as of 03:03, 26 September 2018

This checklist is used by the Eclipse top-level project in preparing its releases.

  1. Copyright notices
    • All features should have "(c) Copyright Eclipse contributors and others 2000, 2018. All rights reserved." in Help > About Eclipse SDK
    • Splash screen copyright needs to be updated
  2. Plug-in and feature identification [Dani]
    • Check the info in Help > About Eclipse SDK
    • All features should have provider "Eclipse.org" and a version that adheres to the Versioning guidelines
    • All plug-ins should have provider "Eclipse.org" and version Versioning guidelines, except for known special cases (org.apache.*, org.junit, and bundles from Orbit).
  3. License agreements for features and plug-ins [Dani]
    • Help > About Eclipse SDK > {Feature | Plug-in} Details > More Info
    • All features should link to the Eclipse Foundation Software User Agreement dated February 1, 2011
    • All plug-ins should link to the plug-in's about.html file containing its plug-in-specific license
  4. Extension point documentation
    • Extension points must be documented in the appropriate help book
      • Platform Plug-in Developer Guide; section Reference / Extension Points Reference
      • JDT Plug-in Developer Guide; section Reference / Extension Points Reference
      • PDE Guide; section Reference / Extension Points Reference
    • Must be a link to each extension point that a component has
    • Extension points added in this release must be clearly marked "Since x.y" where x.y is the project release number
    • See also ISV doc checklist
  5. API documentation
    • Java API must be documented in the appropriate help book
      • Platform Plug-in Developer Guide; section Reference / API Reference
      • JDT Plug-in Developer Guide; section Reference / API Reference
      • PDE Guide; section Reference / API Reference
    • Must be a link to each API package that a component has
    • API package must have package overview (package.html)
    • All API elements must be documented
    • API elements added in this release must be tagged "@since x.y" where x.y is the bundle version number
    • See also ISV doc checklist and code checklist
  6. User Documentation
  7. API Compatibility
    • Make sure that the 'API Tools Version Verification Report' lists no compatibility and no bundle version warning for your bundles
    • Verify that the 'API Tools Post-API Freeze Report' has no entries
  8. Plug-in Migration Guide
    • Instructions for migrating older plug-ins to current release
    • Must describe incompatibilities and breaking API changes
    • Should describe deprecations and places where current release has a better story that plug-ins should more to
    • Located in Platform Plug-in Developer Guide / Porting Guide
    • Remove old migration guide if necessary (we generally keep three years of migration guides available in each release)
  9. What's New
    • Describes the more interesting differences that users will see when they upgrade to the latest release
    • Located in {Workbench | Java Development | PDE} User Guide / What's new
  10. Make sure all bugs with patches have the iplog+ flag set
  11. Submit the IP Log to Eclipse Legal
  12. Eclipse Project Release Notes
    • Add known problems for each component and other late-breaking news for customers of this release
    • See bug 538337 for details
    • Update other sections of readme based on current release plan
  13. Acknowledgments
    • Each component can thank its contributors on the acknowledgments page. See bug 538336 for details.
  14. Source builds
    • Verify that source builds compile and work on all reference platforms.
  15. Verify that source is included in all SDK features
  16. Test updating from update site to platform runtime to other eclipse SDK and runtime features on reference platforms and assorted VMs
  17. Test the version of PDE build in basebuilder to ensure there aren't any errors
  18. Produce the release review documentation

Back to the top