Table of contents

For creating a new release, you need to have ant installed

  • Change the version number in the following files and push them to master:
    • build.xml
    • composer.json
    • includes/version.php
      • set the version
      • ALWAYS increase the revision, otherwise people using the develop branch will be stuck in the updater(!)
      • set the release status (dev for pre-release versions. empty for release)
  • Switch to your bash (this script is for unix based systems)
cd /tmp/
git clone kimai-master
cd kimai-master
git tag -a -f -m 'Tagged version x.x.x' x.x.x
git push origin x.x.x
composer install
ant build
  • Now open GitHub, create a new “Release” as Draft and upload the release ZIP from /tmp/kimai/ to this draft
  • Add one or two sentences and a link to this versions milestone with the “closed” filter
  • Publish the release draft
  • Publish a new blog post regarding this new release (see below)
  • Update kimai.json and change the version number and news link, commit and push it to master (so the update check in Kimai administration will catch it as well)
  • Edit the GitHub release and add a link to the blog post
  • Let the rest of the team know and spread the word (Twitter, Facebook …)