wiki:ReleasePractices/Website

Version 3 (modified by Daniel James, 10 years ago) ( diff )

--

This all requires quickbook and python on your path. Working on the live site directly, so check the changes before checking in. The site is checked out from:

https://svn.boost.org/svn/boost/website/public_html/live/

Cycle start

  • Copy template from feed/templates/boost_x_xx_x.qbk to feed/history/boost_1_50_0.qbk (using the appropriate version number).
  • svn add that file.
  • Edit file to use the correct version number.
  • Run site-tools/update.py.
  • svn add the new release notes file created in users/history/.
  • Check the changes are okay (dev.rss should be the only updated feed, also some changes to generated/state).

Updating release notes

  • Edit feed/history/boost_1_50_qbk (using the appropriate version number).
  • Run site-tools/update.py
  • Check the changes are okay (if there are no status changes then only the release notes html page, the dev.rss feed, and files under generated/state should be updated).
  • Check the changes in.

Add documentation to site (beta and final, requires ssh access, and write permissions for site)

  • ssh into the site
  • Download the boost_version.tar.bz2 file using wget.
  • Expand using tar -xjf.
  • Move to site using sudo mv boost_version /u/grafik/www.boost.org/archives/live/
  • Store the compressed file: sudo mv boost_version.tar.bz2 /u/grafik/www.boost.org/archives/live/zipfiles

Beta release

  • Put documentation on server as above.
  • It should be immediately available on the web server (the version check ignores beta versions)
  • Add the status, download and documentation tags to the release notes, something like:
    [status beta]
    [download http://sourceforge.net/projects/boost/files/boost/1.50.0.beta.1/]
    [documentation /doc/libs/1_50_0_beta1/]
    

Release candidate

This is optional. Just to get the documentation up.

  • Put documentation on server as above.
  • website/public_html/live/common/menu-doc.html:
    • Edit menu link.
  • website/public_html/live/doc/.htaccess:
    • Redirect from development to new version.
    • Remove redirect to beta version (if present).
  • TODO: Set maximum version in php.
  • Check changes, commit, check on the site that they've worked.
  • Release notes:
    • Update documentation link.
    • update & commit.

Release

Some of these might have been done for the release candidate.

  • Put documentation on server as above.
  • website/public_html/live/common/menu-doc.html:
    • Edit menu link.
  • website/public_html/live/doc/.htaccess:
    • Redirect from development to new version.
    • Remove redirect to beta version (if present).
  • common/code/boost.php:
    • Update version.
  • Check changes, commit, check on the site that they've worked.
  • Release notes:
    • Copy date from email into last-revision.
    • Set status to released.
    • Update download link.
    • Update documentation link.
    • update & commit.
Note: See TracWiki for help on using the wiki.