Changes between Version 95 and Version 96 of TracDev/ReleaseChecklist

Timestamp:

Jul 20, 2015, 8:08:53 AM (9 years ago)

Author:

figaro

Comment:

Cosmetic changes

TracDev/ReleaseChecklist

@@ -43 +43 @@
 
 === Check the t.e.o wiki
- * Update the TracChangeLog page 
- * Verify TracInstall and TracUpgrade
+
+ * Update the TracChangeLog page.
+ * Verify TracInstall and TracUpgrade.
  * For major releases:
-   * check TracDev/ReleaseNotes, go through the tickets which have an empty //Release Notes// field and say a word there
-   * check TracDev/ApiChanges
+   * Check TracDev/ReleaseNotes, go through the tickets which have an empty //Release Notes// field and say a word there.
+   * Check TracDev/ApiChanges.
 
 === Check the source
 
 ==== Wiki related files
- * Verify that TracStandalone#Reference matches current `tracd --help`
- * Verify that [source:trunk/trac/wiki/default-pages trac/wiki/default-pages]
-   matches the list of pages in TracProject/DefaultWikiPages
- * [TracProject/DefaultWikiPages#sync Sync] the wiki
- * Update [source:trunk/RELEASE RELEASE] from wiki TracChangeLog
+
+ * Verify that TracStandalone#Reference matches current `tracd --help`.
+ * Verify that [source:trunk/trac/wiki/default-pages trac/wiki/default-pages] matches the list of pages in TracProject/DefaultWikiPages.
+ * [TracProject/DefaultWikiPages#sync Sync] the wiki.
+ * Update [source:trunk/RELEASE RELEASE] from wiki TracChangeLog.
  * Sync [source:trunk/INSTALL INSTALL] from wiki TracInstall using [browser:/trunk/contrib/wiki2rst.py contrib/wiki2rst.py]
  {{{#!sh
@@ -67 +68 @@
 
 ==== Other repository files
- * Remove extraneous whitespace in python source files using [pypi:reindent]
- * Import the translations from Transifex [wiki:TracL10N/Transifex#group3 that have no committers]
- * Check the [source:trunk/THANKS THANKS] and [source:trunk/AUTHORS AUTHORS] files
+
+ * Remove extraneous whitespace in python source files using [pypi:reindent].
+ * Import the translations from Transifex [wiki:TracL10N/Transifex#group3 that have no committers].
+ * Check the [source:trunk/THANKS THANKS] and [source:trunk/AUTHORS AUTHORS] files.
  * Check version number in [source:trunk/setup.py setup.py], 
    [source:trunk/trac/wiki/default-pages/WikiStart trac/wiki/default-pages/WikiStart],
-   and [source:trunk/trac/__init__.py trac/__init__.py]
- * Check that the jQuery and jQuery UI version numbers mentioned in the help match the actual ones (see for example r11041) 
- * Comment out `tag_build` setting in
-   [source:trunk/setup.cfg setup.cfg]
- * Update copyright year on [browser:/trunk/trac/templates/about.html@13499:46#L23 about] page and [source:trunk/COPYING COPYING] file
- * Check whether there are any eligible changesets that have not been merged into the branch
+   and [source:trunk/trac/__init__.py trac/__init__.py].
+ * Check that the jQuery and jQuery UI version numbers mentioned in the help match the actual ones, see for example r11041. 
+ * Comment out `tag_build` setting in [source:trunk/setup.cfg setup.cfg].
+ * Update copyright year on [browser:/trunk/trac/templates/about.html@13499:46#L23 about] page and [source:trunk/COPYING COPYING] file.
+ * Check whether there are any eligible changesets that have not been merged into the branch.
 
 === Prepare packages
 
 ==== Prerequisites
- * use Python **2.7.9** or later on Windows
+
+ * Use Python **2.7.9** or later on Windows.
  * **Babel** must be installed in the environment used to build the packages on Windows.
  * [https://pythonhosted.org/setuptools/history.html#id52 setuptools >= 0.8] should be used to ensure PEP-0440 compliant version identifiers.
- * if svn >= 1.7 is used for the checkout then [https://pypi.python.org/pypi/setuptools_subversion setuptools_subversion] must be installed.
+ * If svn >= 1.7 is used for the checkout then [pypi:setuptools_subversion setuptools_subversion] must be installed.
 
 ==== Create dist packages
- * Check out trunk (or the release branch) to a '''clean''' sandbox
+
+ * Check out trunk (or the release branch) to a '''clean''' sandbox.
  * Build source archives on Unix:
-   {{{#!sh
-   python setup.py sdist --formats=gztar,zip
-   }}}
-   in order to get the files in `.tar.gz` and `zip` archives, with the proper LF line endings.
+ {{{#!sh
+python setup.py sdist --formats=gztar,zip
+}}}
+   to get the files in `.tar.gz` and `zip` archives, with the proper LF line endings.
  
- * Build Windows exe installers on x86 and x64 platforms.
+ * Build Windows exe installers on x86 and x64 platforms:
  {{{#!dos
 python.exe setup.py bdist_wininst
@@ -101 +104 @@
 
 ==== Verify installation on target platforms
-  * Install on a clean system. ''Remove any old Trac installation before testing.''
-  * Smoke test:
+
+ * Install on a clean system. ''Remove any old Trac installation before testing.''
+ * Smoke test:
    - create an environment with `trac-admin`, test it with `tracd`
-   - upgrade an environment created with the previous release' `trac-admin`,
-     test it with `tracd`
+   - upgrade an environment created with the previous release' `trac-admin`, test it with `tracd`
 
 ==== Upload packages
- * //[https://packaging.python.org/en/latest/distributing.html#uploading-your-project-to-pypi Upload] the packages to [http://pypi.python.org/pypi/Trac PyPi] using Twine (*)//
- * Upload to http://ftp.edgewall.org/pub/trac
+
+ * //[https://packaging.python.org/en/latest/distributing.html#uploading-your-project-to-pypi Upload] the packages to [http://pypi.python.org/pypi/Trac PyPi] using Twine (*)//.
+ * Upload to http://ftp.edgewall.org/pub/trac.
 
 === Finalize the release
- * Test `easy_install Trac`
- * Tag/copy version in subversion
- * Update TracDownload and [wiki:TracDev/ReleaseNotes/1.1#DevelopmentReleases]
- * Close release coordination ticket (e.g. #9077) (*)
+
+ * Test `easy_install Trac`.
+ * Tag/copy version in subversion.
+ * Update TracDownload and [wiki:TracDev/ReleaseNotes/1.1#DevelopmentReleases].
+ * Close release coordination ticket, eg #9077. (*)
  * Mark the finished milestones as //completed// (with the //completed date// preferably being the date that the releases were announced), and change their descriptions from //next// maintenance/development release to //latest// maintenance/development release.
    * The next set of milestones should have their descriptions changed to //next// maintenance/development release.
    * The previous set of milestones should have their descriptions changed to remove the ''latest maintenance/development release'' message.
    * Attach copy of translations statistics chart of Transifex to the milestones.
- * Add [/admin/ticket/versions Version] entries for the new releases (*)
+ * Add [/admin/ticket/versions Version] entries for the new releases. (*)
 
 === Announce the release
+
  * Post to the following channels:
   * [gforum:trac-users], [gforum:trac-dev] (all releases) 
@@ -130 +136 @@
  /msg ChanServ topic #trac "The topic is: http://trac.edgewall.org/ | http://trac-hacks.org/ | Latest version - <version>."
 }}}
- * Update the versions on the [wikipedia:trac Wikipedia] page.
+ * Update the [wikipedia:trac Wikipedia] page, and in particular the version numbers.
 
 === Prepare for development
- * Uncomment `tag_build` setting in
-   [source:trunk/setup.cfg setup.cfg]
- * Update version number in [source:trunk/setup.py setup.py], 
-   [source:trunk/trac/wiki/default-pages/WikiStart trac/wiki/default-pages/WikiStart], 
-   and [source:trunk/trac/__init__.py trac/__init__.py] 
+
+ * Uncomment `tag_build` setting in [source:trunk/setup.cfg setup.cfg].
+ * Update version number in [source:trunk/setup.py setup.py], [source:trunk/trac/wiki/default-pages/WikiStart trac/wiki/default-pages/WikiStart], and [source:trunk/trac/__init__.py trac/__init__.py].
  * Create a release coordination ticket with keyword [kwquery:release].
  * Update the [ReleaseTesting#Currenttargetreleases Current target releases].