doc/ReleaseChecklist.txt

   1 Barry Release Checklist:
   2 ------------------------
   3 - bump version numbers in
   4         Source locations:
   5                 - configure.ac (2 places)
   6                 - gui/configure.ac
   7                 - opensync-plugin/configure.ac
   8                 - opensync-plugin-0.4x/configure.ac
   9                 - desktop/configure.ac (2 places)
  10                 - libbarry*.pc.in (renamed for major version... also, requires
  11                         version changes inside those .pc files, in the
  12                         Requires: field)
  13                         - if renamed, update following:
  14                                 - Makefile.am (root dir)
  15                                 - all configure.ac files
  16
  17         Documentation:
  18                 - doc/www/index.php
  19                 - Doxyfile
  20                 - update root README file as necessary
  21
  22         Binary packaging:
  23                 - rpm/barry.spec
  24
  25                 - debian/changelog
  26                 - debian/control (major version only)
  27                 - debian/libbarry*.* (files need to be renamed)
  28                 - debian/rules (the barry18 includedir)
  29                 - debian/*.lintian-overrides (major version only)
  30
  31                 - opensync-plugin/debian/changelog
  32                 - opensync-plugin/debian/control (libbarry-dev)
  33
  34                 - opensync-plugin-0.4x/debian/changelog
  35                 - opensync-plugin-0.4x/debian/control (libbarry-dev)
  36
  37         Languages:
  38                 - files under:
  39                         po/
  40                         gui/po/
  41                         desktop/po/
  42                         desktop/po-osyncwrap/
  43                         opensync-plugin/po/
  44                         opensync-plugin-0.4x/po/
  45
  46         Misc:
  47                 - android/jni/barry/config.h (multiple version strings)
  48                 - wince/.../config.h
  49                 - test/nightly.sh
  50
  51 - tests in following order:
  52         - run 'make update-po' periodically in each po directory to
  53                 update translation work
  54         - test ABI / API and bump major or minor version as appropriate
  55         - run tests under test/
  56         - starting from a fresh sid base, test build-deps, build debian
  57                 packages, and run sid lintian (only sid, since overrides
  58                 in Barry are specific to sid):
  59                 lintian --info --display-info --pedantic --color auto \
  60                         *.changes *.deb *.dsc
  61         - double check hardening on sid:
  62                 hardening-check tmp/usr/bin/barrydesktop
  63                 hardening-check tmp/usr/lib/libbarry.so.18
  64                 - between both, should show all options enabled
  65         - run binary-meta release build test (remember that chroot builds
  66                 need a password, so run them first if running a batch)
  67 - write release notes, including contributors, known issues, new
  68         features and bugs fixed
  69         - include mention of distros that support Barry:
  70                 (see AUTHORS file for distro list)
  71         - include description at the top of what Barry is
  72 - web docs:
  73         - update known issues list
  74         - check that all external links work, and point to proper content
  75         - upload latest web docs to netdirect project page
  76                 - run: ./static.sh netdirect
  77         - upload latest doxygen docs to netdirect project page
  78 - snip this version's git shortlog history into its own file
  79 - sign-tag Barry git repo and binary-meta git repo with latest version
  80 - no need to run maintainer/tagged-release.sh since you're maintainer now
  81 - manually push git tags to repo.or.cz and sourceforge.net
  82 - create binary-meta tree under dists/, and debian source packages and tarballs,
  83         including binary-meta tarball, under sources/
  84         ./make-apt.sh bmbuild
  85         ./make-yum.sh bmbuild
  86         ./make-slimdist.sh bmbuild
  87 - upload above tree to SourceForge
  88         ssh -x -a -2 -t USER,PROJECT@shell.sourceforge.net create
  89            then use sf-help for details
  90         MAKE SURE that the tar source files are under
  91                 /files/barry/barry-{version}/barry_{version}.tar.gz,
  92                 so that debian/watch remains accurate
  93 - upload binary packaging metadata to download.barry.netdirect.ca
  94         under a versioned directory (eg. barry-0.18.0/) and update the
  95         barry-latest symlink
  96         - remember to run make-redirect.sh for both the new release dir
  97                 and barry-latest symlink
  98                 For example:
  99                 ./make-redirect.sh bmbuild /barry-0.18.3 http://sourceforge.net/projects/barry/files/barry/barry-0.18.3/bmbuild
 100                 ./make-redirect.sh bmbuild /barry-latest http://sourceforge.net/projects/barry/files/barry/barry-0.18.3/bmbuild
 101         - add the new release to .htaccess, and replace barry-latest
 102                 redirect links with the new ones
 103         - make backup of new htaccess in your local release directory
 104 - send announcement to devel and announce mailing list, including:
 105         - release notes
 106         - shortlog
 107         - URLs to sourceforge and OpenSUSE Build Service binary packages
 108         - URL to netdirect doc page
 109         - send email notice to intrigeri including:
 110                 - name of upstream tag (i.e. barry-0.18.3-2)
 111                 - example of upstream diff
 112                         git log -p barry-0.18.3..barry-0.18.3-2
 113                 - release URL directly to the .dsc file
 114 - submit tracker news item at SourceForge
 115 - update Freshmeat entry
 116 - update Sourceforge screenshots / icons if applicable
 117 - update source project, bumping revision numbers in source code
 118