[gnuastro-commits] master 64c4874 1/3: A release checklist added to facilitate releases

[Mohammad Akhlaghi]

branch: master
commit 64c48748f36ff04e4afd0df6e21143d78384391f
Author: Mohammad Akhlaghi <address@hidden>
Commit: Mohammad Akhlaghi <address@hidden>

    A release checklist added to facilitate releases
    
    Since there are many things to do before a release, the
    `doc/release-checklist.txt' checklist has been created. It includes all the
    operations that should take place prior to making a release. Having this
    file will facilitate more frequent releases.
    
    At this stage, the file is just a place-holder, with a crude list of items
    that came to my mind right now. It will be complete and tested with the 0.2
    release and the beta-release a few days before that. It doesn't need to go
    into the distribution, it should just be version controlled.
---
 doc/release-checklist.txt |   47 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)

diff --git a/doc/release-checklist.txt b/doc/release-checklist.txt
new file mode 100644
index 0000000..0a5a3aa
--- /dev/null
+++ b/doc/release-checklist.txt
@@ -0,0 +1,47 @@
+Gnuastro release checklist
+==========================
+
+This file is primarily intended for the Gnuastro maintainer and lists the
+set of operations to do before making each release. This should be done
+after all the commits needed for this release have been completed.
+
+IMPORTANT NOTE: This is currently a draft, it will be complete with the 0.2
+version release.
+
+ - Update the NEWS file (use `git log --reverse gnuastro_vA.B..HEAD').
+
+ - Check if README includes all the recent updates and important features.
+
+ - Check if THANKS is up to date and include recently updated
+   people/institutions.
+
+ - Update the library version in (`lib/Makefile.am'). See the `Updating
+   library version information' section of the GNU Libtool manual as a
+   guide.
+
+ - Commit all the changes and tag the commit.
+
+ - Make sure all the bootstrapping tools are up to date (keep the versions
+   somewhere to use in the release).
+
+ - `git clean -fxd'
+
+ - `./bootstrap --copy --gnulib-srcdir=/path/to/gnulib'
+
+ - `./tmpfs-config-make'
+
+ - `cd build'
+
+ - `make distcheck -j8'
+
+ - Generate the GNU FTP upload script. This step and later steps will be
+   added later.
+
+ - Update the links on the webpage (`doc/gnuastro-top.html' and possible
+   translations).
+
+ - Build the full webpage (the `doc/forwebpage' script) and check if
+   everything is OK after the upload.
+
+ - Announce the release on address@hidden', address@hidden' and
+   Savannah.