DOC: add instructions for updating the docs to HOWTO_RELEASE.txt

1 files changed, 38 insertions, 0 deletions

diff --git a/doc/HOWTO_RELEASE.txt b/doc/HOWTO_RELEASE.txt
index e1459be22..052dbf543 100644
--- a/doc/HOWTO_RELEASE.txt
+++ b/doc/HOWTO_RELEASE.txt
@@ -200,6 +200,15 @@ The edits in the documentation wiki suitable for merging should be merged,
 ideally just before making the release branch. How to do this is described in
 detail in doc/HOWTO_MERGE_WIKI_DOCS.txt.
 
+Check that docs can be built
+----------------------------
+Do::
+
+    cd doc/
+    make dist
+
+to check that the documentation is in a buildable state.
+
 Check deprecations
 ------------------
 Before the release branch is made, it should be checked that all deprecated
@@ -263,6 +272,35 @@ interface. A simple binary installer for windows, created with
 ``bdist_wininst``, should also be uploaded to PyPi so ``easy_install numpy``
 works.
 
+Update docs.scipy.org
+---------------------
+Do the following (or ask the doc people to take care of it):
+
+Rebuild and upload documentation:
+
+- ``cd numpy/doc``
+- ``make dist``
+- Check that the built documentation is OK.
+- ``touch output-is-fine``
+- ``make upload UPLOAD_TARGET=USERNAME@docs.scipy.org:/home/docserver/www-root/doc/numpy-1.5.x/``
+
+where USERNAME should be replaced by your account on
+``docs.scipy.org``, and ``numpy-1.5.x`` by the version number of the
+*release series*. For instance, for Numpy 1.5.1, it should be
+``numpy-1.5.x`` and for Numpy 2.0.0 ``numpy-2.0.x``.
+
+Rebuild and upload ``docs.scipy.org`` front page, if the release
+series is a new one. The front page sources are located in the Scipy
+repository:
+
+- ``cd scipy/doc/frontpage``
+- Edit ``_templates/indexcontent.html`` to add links to the new release series.
+- ``make dist``
+- Check that the built documentation is OK.
+- ``touch output-is-fine``
+- ``make upload USER=USERNAME``
+
+
 Update scipy.org
 ----------------
 A release announcement with a link to the download site should be placed in the