= Checklist of things to do before a release =

A simple reminder list:

== Check the t.e.o wiki ==
 * Update the ChangeLog page 
 * Verify TracInstall and TracUpgrade

== Check the source ==
(replace ''trunk'' below with the corresponding branches/0.1X-stable when preparing a minor releases)


=== Wiki related files
 * If needed, do a last [TracProject/DefaultWikiPages#RepeatMerge sync]
 * Verify that [source:trunk/trac/wiki/default-pages]
   contains all pages listed in TracProject/DefaultWikiPages
 * Check all default wikipages for TracLinks to nonexistant pages/resources
 * Update [source:trunk/RELEASE] from wiki ChangeLog
 * Update [source:trunk/ChangeLog] from wiki ChangeLog
 * Update [source:trunk/INSTALL] from wiki TracInstall 
 * Update [source:trunk/UPGRADE] from wiki TracUpgrade

=== Other repository files
 * Check the [source:trunk/THANKS] file
 * Update version number in [source:trunk/setup.py], 
   [source:trunk/trac/wiki/default-pages/WikiStart], 
   and [source:trunk/trac/__init__.py]
 * Comment out `tag_build` and `tag_svn_revision` settings in
   [source:trunk/setup.cfg]

== Create dist packages ==

// Note: be sure to use Python 2.6.5 on Windows //

   * Check out trunk (or the release branch) to a '''clean''' sandbox
   * Build source tarballs:
     - On Unix: 
       {{{
       python setup.py sdist
       }}}
       in order to get the files in a `.tar.gz`, with the proper LF line endings.
     - On Windows:
       {{{
       python setup.py sdist
       }}}
       in order to get the files in a `.zip`, with the proper CRLF line endings.
       Verify with zipinfo that the content is OK as once the templates were 
       missing...
   * Build Windows installer
     - .exe win32 installer
       {{{
       python.exe setup.py bdist_wininst
       }}}
   * Test installation on all target platforms. \\
     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`

== Finalize the release
 * Tag/copy version in subversion
 * Upload to http://ftp.edgewall.org/pub/trac
 * Update TracDownload
 * Test `easy_install Trac`
 * Update [http://pypi.python.org/pypi/Trac PyPi entry]
 * Post on Trac-users, Trac-dev (all releases) 
   and Trac-announce (only for non-beta releases)
 * Update [http://freshmeat.net/projects/trac Freshmeat entry]
 * Close release coordination ticket (e.g. #9077)

 
----
See also: TracDev