Releasing 3.1.5

Releasing 3.1.5.md

Todo List for 3.1.5

General

• Make sure phpBB/docs/CREDTIS.txt is up to date

• Make sure Contributors have their ranks

• Make sure all reports in the security tracker are closed or invalid

• Go through Issues fixed in 3.1.5 and correct any unreadable descriptions

• Check the feature hightlights wiki page for completeness

• Branch of prep-release-3.1.5 from 3.1.x:

  git checkout 3.1.x
  git checkout -b prep-release-3.1.5

Release candidate 1

Before Packaging

• Update version number in prep-release-3.1.5 to 3.1.5-RC1 in these files:

  • build/build.xml
  • phpBB/includes/constants.php
  • phpBB/install/schemas/schema_data.sql

• Update version number in prep-release-3.1.5 to 3.1.5 in these files:

  • phpBB/install/convertors/convert_phpbb20.php
  • phpBB/styles/prosilver/style.cfg
  • phpBB/styles/subsilver2/style.cfg

• Create Migration v315rc1 depending on all migrations added after v314 and v314 itself

  php phpBB/bin/phpbbcli.php dev:migration-tips

• Commit Changelog generated from Tracker: phpBB/docs/CHANGELOG.html

  php build/build_changelog.php 3.1.5-RC1

• Update list of events in the Wiki: https://wiki.phpbb.com/Event_List

  php phpBB/develop/export_events_for_wiki.php all

• Update list of changed events in the release highlights: https://wiki.phpbb.com/Release_Highlights/3.1.5

  php phpBB/develop/export_events_for_wiki.php diff 3.1.5-RC1

Packaging

• Build packages

  cd build
  ../phpBB/vendor/bin/phing

After packaging

• Test install of 3.1.5-RC1 package

• Test update from 3.1.4 to 3.1.5-RC1

• Test update from 3.0.14 to 3.1.5-RC1

• Tag prep-release-3.1.5 as release-3.1.5-RC1

  git tag -a release-3.1.5-RC1 -m "Tagging the 3.1.5-RC1 release."

• Upload packages

• Make sure packages have correct permissions for downloading

• Update area51 downloads page: src/Phpbb/Area51Bundle/Controller/DefaultController.php

• Set release date for version 3.1.5-RC1 on the PHPBB3 and SECURITY trackers

• Move all bug reports assigned to fix version "3.1.5-RC1" to "3.1.6-RC1" in the PHPBB3 and SECURITY trackers

• Post language changes for translators

  git diff release-3.1.4 release-3.1.5-RC1 phpBB/language/ > language_changes_3.1.4_to_3.1.5-RC1.diff

• Post style changes for style authors

  git diff release-3.1.4 release-3.1.5-RC1 phpBB/styles/prosilver/ > prosilver_changes_3.1.4_to_3.1.5-RC1.diff
  git diff release-3.1.4 release-3.1.5-RC1 phpBB/styles/subsilver2/ > subsilver2_changes_3.1.4_to_3.1.5-RC1.diff

• Post announcement on Area51 and Teams forum: including the language and style changes

• Update versioncheck unstable version

• Merge prep-release-3.1.5 into 3.1.x and 3.1.x into master

  git checkout 3.1.x
  git merge --no-ff prep-release-3.1.5

• Update version number in 3.1.x to 3.1.6-dev in these files:

  • build/build.xml
  • phpBB/includes/constants.php
  • phpBB/install/schemas/schema_data.sql

• Merge 3.1.x into master

  git checkout master
  git merge --no-ff 3.1.x

• Push changes

  git push phpbb release-3.1.5-RC1
  git push phpbb prep-release-3.1.5
  git push phpbb 3.1.x master

Final Packaging

Before Packaging

• Update version number in prep-release-3.1.5 to 3.1.5 in these files:

  • build/build.xml
  • phpBB/includes/constants.php
  • phpBB/install/schemas/schema_data.sql

• Create Migration v315 depending on all migrations added after v315rc1 and v315rc1 itself

  php phpBB/bin/phpbbcli.php dev:migration-tips

Packaging

• Build packages

  cd build
  ../phpBB/vendor/bin/phing

After Packaging

• Test install of 3.1.5 package

• Test update from 3.1.4 to 3.1.5

• Test update from 3.0.14 to 3.1.5

• Test conversion from 2.0.x to 3.1.5

• Tag prep-release-3.1.5 as release-3.1.5

  git tag -a release-3.1.5 -m "Tagging the 3.1.5 release."

• Upload packages

• Make sure packages have correct permissions for downloading

• Set release date for version 3.1.5 on the PHPBB3 and SECURITY trackers

• Make sure the version "3.1.5" is in the version constraint of the issue filter

• Post language changes for translators No changes, see above

• Post style changes for style authors No changes, see above

• Merge prep-release-3.1.5 into 3.1.x and 3.1.x into master

  git checkout 3.1.x
  git merge --no-ff prep-release-3.1.5
  git checkout master
  git merge --no-ff 3.1.x

• Push changes

  git push phpbb release-3.1.5
  git push phpbb prep-release-3.1.5
  git push phpbb 3.1.x master

• Update website downloads page

• Prepare an announcement in BBCode and E-Mail form:

  git shortlog -sn release-3.1.4...release-3.1.5
  git diff --stat release-3.1.4...release-3.1.5

• Post announcement on phpBB.com