From 5744340cdadddb32815e5581dc43b67c2f651c47 2011-04-09 08:26:12
From: Fernando Perez <Fernando.Perez@berkeley.edu>
Date: 2011-04-09 08:26:12
Subject: [PATCH] Update docs with some release info.

---

diff --git a/docs/source/development/release.txt b/docs/source/development/release.txt
index f857624..a24dc21 100644
--- a/docs/source/development/release.txt
+++ b/docs/source/development/release.txt
@@ -10,8 +10,14 @@ Our release process is currently not very formal and could be improved.
 Most of the release process is automated by the :file:`release` script in the
 :file:`tools` directory.  This is just a handy reminder for the release manager.
 
-#. First, run :file:`build_release`, which does all the file checking and
-   building that the real release script will do.  This will let you do test
+#. For writing release notes, this will cleanly show who contributed as author
+   of commits (get the previous release name from the tag list with ``git
+   tag``)::
+
+   git log --pretty=format:"* %an" PREV_RELEASE... | sort | uniq
+
+#. Run :file:`build_release`, which does all the file checking and building
+   that the real release script will do.  This will let you do test
    installations, check that the build procedure runs OK, etc.  You may want to
    disable a few things like multi-version RPM building while testing, because
    otherwise the build takes really long.
@@ -22,11 +28,19 @@ Most of the release process is automated by the :file:`release` script in the
 #. Update the website with announcements and links to the updated changes.txt
    in html form. Remember to put a short note both on the news page of the 
    site and on Launcphad.
-
+   
 #. Drafting a short release announcement with i) highlights and ii) a link to
    the html version of the :ref:`Whats new <whatsnew_index>` section of the 
    documentation.
 
-#. Make sure that the released version of the docs is live on the site.
+#. Make sure that the released version of the docs is live on the site.  For
+   this we are now using the gh-pages system:
+
+   - Make a static directory for the final copy of the release docs.
+   - Update the :file:`index.rst` file and run :file:`build_index.py` to update
+     the html version.
+   - Update the ``stable`` symlink to point to the released version.
+   - Run ``git add`` for all the new files and commit.
+   - Run ``git push`` to update the public version of the docs on gh-pages.
 
 #. Celebrate!
\ No newline at end of file