Making a Release of Tasque

If you're used to doing this, it'll probably take about an hour to make a Tasque release. If you hit a glitch, who knows how long it will take, so plan accordingly.

  • Announce in #tasque that you're about to make a release so they'll stop pushing commits to master (although you may get someone who begs you for a few more minutes for a last-minute-super-risky change)

  • Update to the latest code git pull --rebase

  • Update the NEWS file
    • This is one occasion where git log is your friend.

    • Keep the NEWS file mostly non-technical in nature. You don't have to add every single thing from git log, only the things that would mean the most to end-users. Serious technical issues should be omitted from the NEWS file. Bugs (with the number), are useful however.

  • Build a test tarball
    • Run: make distcheck

    • make distcheck must succeed. Do not make a release if this step fails. Take the time to fix any problems that arise. You'll thank yourself later.

  • Test the tasque-x.y.z.tar.gz file that is generated

    • tar xzvf tasque-x.y.z
      cd tasque-x.y.z
      ./configure --prefix=/tmp/tasque-x.y.z
      make install
      /tmp/tasque-x.y.z/bin/tasque  (this should run tasque w/o issues)
  • If everything worked in the test tarball, commit the NEWS news file.
  • Tag the code in git
    • git tag -a TASQUE_X_Y_Z

    • For a comment, use "Tagging the X.Y.Z release"
    • The tag should be in the following format: TASQUE_{MAJOR}_{MINOR}_{RELEASE}
      • e.g., TASQUE_0_1_0

    • Good idea to double-check that the tag is in the right place in gitk

  • Bump the version one revision in configure.ac and commit it
    • e.g., 0.1.0 -> 0.1.1

    • This allows others to start developing in master again
  • Push these commits to git.gnome.org
    • git push origin HEAD TASQUE_X_Y_Z

  • Install the tarball on master.gnome.org
    • md5sum tasque-x.y.z    (note the value, you'll use it later)
      scp tasque-x.y.z {your-GNOME-username}@master.gnome.org:.
      ssh {your-GNOME-username}@master.gnome.org
      md5sum tasque-x.y.z    (make sure it matches with the MD5 on your machine)
      install-module tasque-x.y.z    (follow instructions, usually just answer Y)
    • If this step is successful, you should see the tar.gz and tar.bz2 appear here (after a few minutes): http://ftp.gnome.org/pub/GNOME/sources/tasque/

  • Update the Download web page

  • Make sure you're subscribed to tasque-list@gnome.org, gnome-announce-list@gnome.org and mono-announce-list@lists.ximian.com

  • Send an ANNOUNCE email:
  • You're done! WHEW!

Apps/Tasque/MakeRelease (last edited 2013-08-09 00:53:18 by WilliamJonMcCann)