The following steps have to be taken for building a new release.

1. push the current stable branch to the oldstable branch
2. run unit tests
3. prepare a todo of bugs to be fixed
4. find a code name
   • Discworld Character
   • add RC1 for release candidate
5. prepare changes summary
6. make sure the MD5 for conf/dokuwiki.php in the installer is correct; this includes
   1. checking the MD5 value
   2. checking whether the installer fails
7. increase the update_check msg number in doku.php
8. update list of deleted files

   • git diff stable..HEAD --summary |grep  '^ delete'|awk '{print $4}'|grep -v VERSION

   • add them to data/deleted.files
   • add them to upgrade
9. push the release preparations above to the master branch
10. merge git master branch into the stable branch
11. update the VERSION file in the stable branch
    • Format: YYYY-MM-DD “code name”
12. tag the release in the git stable branch
13. build the .tgz (See build script below)
14. upload the .tgz (needs to be done by Andi currently)
15. update release numbers in bugtracker (needs to be done by Andi or Adrian currently)
16. change message in IRC (needs to be done by Andi currently)
17. announce in fm, wikimatrix (needs to be done by Andi currently)
18. announce in mailing list, forum, weping
19. update update.splitbrain.org (needs to be done by Andi currently)

build.sh

#!/bin/sh
 
BDIR=/home/andi/projects/buildplace
 
cd $BDIR || exit
rm -rf dokuwiki*
 
git clone git://github.com/splitbrain/dokuwiki.git dokuwiki
cd dokuwiki || exit
git checkout -b stable origin/stable
 
VERSION=`cat VERSION|awk {print $1}`
 
rm -rf .gitignore
rm -rf .git
rm -rf _test
rm -rf _cs
rm -f test.php
mkdir data/pages/playground
echo "====== PlayGround ======" > data/pages/playground/playground.txt
 
cd ..
 
mv dokuwiki dokuwiki-$VERSION
 
tar -czvf dokuwiki-$VERSION.tgz dokuwiki-$VERSION
 
echo "now upload: $BDIR/dokuwiki-$VERSION.tgz"