Actions

Difference between revisions of "Release procedure and checklist"

From Joomla! Documentation

(add other db's)
(add build update)
(8 intermediate revisions by one user not shown)
Line 26: Line 26:
 
# Offer test package to testers: [[Bug Squad]] members, [[Development Team ]] members, translation members
 
# Offer test package to testers: [[Bug Squad]] members, [[Development Team ]] members, translation members
 
# If problems are found during this stage, go back to fix the problem. Use the [[Joomla! Maintenance Procedures]] and repeat until tests are performed successfully.
 
# If problems are found during this stage, go back to fix the problem. Use the [[Joomla! Maintenance Procedures]] and repeat until tests are performed successfully.
 +
# Draft the release notes on Joomla.org and post draft to the [http://forum.joomla.org/viewforum.php?f=54 private translation forum].
  
 
=== Execution phase ===
 
=== Execution phase ===
Line 34: Line 35:
 
# Update administrator/manifests/files/joomla.xml file for version number and date.
 
# Update administrator/manifests/files/joomla.xml file for version number and date.
 
# Check joomla.sql file for version number in #__extensions table for Joomla CMS extension
 
# Check joomla.sql file for version number in #__extensions table for Joomla CMS extension
#* mysql, sqlserv, sqlazure
+
#* mysql, sqlazure, postgres
# Check language/en-GB/en-GB.files_joomla.sys.ini file for version number.
+
# Make sure there is at least one .sql update file in the com_admin/sql/updates/<db> folders (to update the db schema).
 +
# Update the build.php for the new version number.
 +
# Check language/en-GB/en-GB.files_joomla.sys.ini file for version number (not needed for minor update).
 
# Enable install check.
 
# Enable install check.
# Tag release in SVN.
+
# Tag release in git and commit to local github repo.
 
# Package build.
 
# Package build.
 
# Offer test package to testers: [[Bug Squad]] members, [[Development Team ]] members, translation members
 
# Offer test package to testers: [[Bug Squad]] members, [[Development Team ]] members, translation members
Line 46: Line 49:
 
## Once package is released, change the Package flags to Visible=Yes, Public=Yes, Require Login=No.
 
## Once package is released, change the Package flags to Visible=Yes, Public=Yes, Require Login=No.
 
## Change the prior version package to Visible=No but leave the prior version release flags as they are.
 
## Change the prior version package to Visible=No but leave the prior version release flags as they are.
# Publish security notices on developer site.
 
# Publish announcement on joomla.org and the forum, change download article links
 
# Make static copy of front page with announcement to be used if server load becomes critical.
 
 
# Update XML file on site for the new version number information.
 
# Update XML file on site for the new version number information.
 
## FTP connect to update.joomla.org and Navigate to www/core
 
## FTP connect to update.joomla.org and Navigate to www/core
 
## Change version attribute in list.xml (don't add new line)
 
## Change version attribute in list.xml (don't add new line)
 
## Add new update element (copy from previous) with new version number and new downloadurl and link to new archive file
 
## Add new update element (copy from previous) with new version number and new downloadurl and link to new archive file
# Publish announcement on forum.
+
## Test auto update from prior version(s)
 +
# Update Joomla.org Download article
 +
# Publish security notices on developer site.
 +
# Publish release announcement on Joomla.org
 +
# Publish announcement on the forum
 +
# Update Wiki: FAQ, Version history
  
 
=== Finalization phase ===
 
=== Finalization phase ===
# Tag SVN.
+
# Push release changes from local to remote Github repo
# Un-freeze the trunk, send e-mail to work groups and mailing lists ([[Development Team]] and [[Bug Squad]]).
+
## Security fixes (if any)
# Undo install check.
+
## Version tag
# Change content on joomla.org and dev.joomla.org (see pages to update)
+
## Version changes (SQL files, version.php, joomla.xml)
# Update MD5 checksum information
+
## Install checks
# Update nightly builds to reflect new release
+
# Update Github repo for new version development
 +
## Remove install checks
 +
## Update version in version.php, joomla.xml, SQL files, SQL update files
  
 
=== Pages to update ===
 
=== Pages to update ===

Revision as of 16:39, 26 April 2013


This is a general checklist when a version of Joomla! is released. Keep in mind that a major release differs a lot from a Minor Release or even a Maintenance Release. The checklist here describes the steps that need to be done for (at least) Maintenance Release and Minor Release.

Contents

Release checklist

It depends on the Development Cycle when the checklist is triggered. A release can be done during every stage of the Development Cycle, it does not matter if you release a beta or a stable version, this is a general checklist that can be used when releasing a new version of Joomla! The checklist starts when it's decided to release a version:

Preparation phase

  1. Communication pre-release: check with PLT on timing
  2. Communication pre-release: inform Bug Squad and LT's about timing
  3. Decision: when the above has positive result, set a date and time for release
  4. Communication pre-release: inform Global Moderators about upcoming release
  5. Communication pre-release: check availability and assign release tasks to JBS and PLT members
  6. 5 days prior to release: freeze trunk for language changes
  7. 2 days prior to release: freeze trunk for all changes, draft release notes to translation teams
  8. 1 day prior to release: build packages for testing
  9. Day of release: set project flags on Joomlacode, update web pages
  10. Announce on forum, announce to LT's

Pre-execution phase

  1. Apply latest translations (need to be delivered by translation work group).
  2. Create test package.
  3. Offer test package to testers: Bug Squad members, Development Team members, translation members
  4. If problems are found during this stage, go back to fix the problem. Use the Joomla! Maintenance Procedures and repeat until tests are performed successfully.
  5. Draft the release notes on Joomla.org and post draft to the private translation forum.

Execution phase

  1. Check for security fixes.
  2. Create release notes document on joomla.org and post copy to translation forum.
  3. Change version information (libraries/cms/version/version.php)
  4. Add entry in CHANGELOG.php file
  5. Update administrator/manifests/files/joomla.xml file for version number and date.
  6. Check joomla.sql file for version number in #__extensions table for Joomla CMS extension
    • mysql, sqlazure, postgres
  7. Make sure there is at least one .sql update file in the com_admin/sql/updates/<db> folders (to update the db schema).
  8. Update the build.php for the new version number.
  9. Check language/en-GB/en-GB.files_joomla.sys.ini file for version number (not needed for minor update).
  10. Enable install check.
  11. Tag release in git and commit to local github repo.
  12. Package build.
  13. Offer test package to testers: Bug Squad members, Development Team members, translation members
  14. If problems are found during this stage, go back to fix the problem. Use the Joomla! Maintenance Procedures and repeat until tests are performed successfully.
  15. Add package to joomlacode.org
    1. Before the release is public, set the joomlacode package flags as follows: Visible=No, Public=No, Require Login=Yes.
    2. Set the Release flags as follows: Visible=Yes, Released=Yes.
    3. Once package is released, change the Package flags to Visible=Yes, Public=Yes, Require Login=No.
    4. Change the prior version package to Visible=No but leave the prior version release flags as they are.
  16. Update XML file on site for the new version number information.
    1. FTP connect to update.joomla.org and Navigate to www/core
    2. Change version attribute in list.xml (don't add new line)
    3. Add new update element (copy from previous) with new version number and new downloadurl and link to new archive file
    4. Test auto update from prior version(s)
  17. Update Joomla.org Download article
  18. Publish security notices on developer site.
  19. Publish release announcement on Joomla.org
  20. Publish announcement on the forum
  21. Update Wiki: FAQ, Version history

Finalization phase

  1. Push release changes from local to remote Github repo
    1. Security fixes (if any)
    2. Version tag
    3. Version changes (SQL files, version.php, joomla.xml)
    4. Install checks
  2. Update Github repo for new version development
    1. Remove install checks
    2. Update version in version.php, joomla.xml, SQL files, SQL update files

Pages to update

  1. Global:
  2. 1.5:
    • Create new Wiki article called 'Category:Version 1.5.X FAQ'. Add an overall note for the release in the body of the article using the previous version as a Guide. Insert the following into the article: [[Category:Version 1.5 FAQ]]. Include a link to the 'Category:Version 1.5.x FAQ' page in the Release notes.
    • Update Version History
    • Update Joomla! Codenames
  3. 1.0:

Calculating Release Statistics

  1. Extract *all* issues from Tracker into spreadsheet. Make note of the date of the last release and the number of active issues at the time of the last release.
  2. Set a filter on the "Closed Date" column to be "after" "the day of the last release".
    • Calculate "Closed" count by aggregating status values for Closed, Duplicate Report, Known Issue, Not a bug, Not Joomla! Core, Unable to Confirm.
    • Calculate "Fixed in SVN" count by aggregating status values for Open and Information Required. (Note: this value is presented two times in the report.)
  3. Set a filter on the "Closed Date" column to be blanks:
    • Calculate "Open" count by aggregating status values for "Open" and "Information Required."
    • Calculate "Confirmed" count by aggregating status values for "Confirmed" and "In Progress."
    • Calculate "Pending" count by aggregating status values for "Pending" and "Ready to Commit."
  4. Calculate the "New Active Issues" by aggregating the "Open", "Confirmed" and "Pending" counts.
  5. Calculate the "net increase/decrease" by subtracting the "Last Release Active Issues" from the "New Active Issues."
  6. Count the "number of commits" by reviewing the CHANGELOG.php file and counting the documented commits.

Alternative Method for Stats

  • Fixed in SVN: Create query with close date > date of prior release and status = Fixed in SVN.
  • Commits: Count from CHANGELOG.php as indicated above.
  • New Reports: Run query with all status codes and open date > date of prior release.
  • Increase / decrease in active issues: See note below
  • Closed: Run query with closed date > date of prior release and status code one of Closed, Duplicate Report, Known Issue, Not a bug, Not Joomla! Core, Unable to Confirm.
  • Open at time of release: query of all issues with status = Open or Information Required
  • Confirmed at time of release: query of all issues with status = Confirmed or In Progress
  • Pending at time of release: query of all issues with status = Pending or Ready to Commit

Increase/Decrease in Active Issues

  • Total active issues now = Open at time of release + Confirmed at time of release + Pending at time of release
  • This number minus the total active as of prior release is the net increase or decrease

As a check, make sure the following formula works:

  • Prior release total active issues + New Reports - (Closed + Fixed in SVN) should equal the Total Active Issues now.