doc: release howto updates

Author: ariddell

doc/release-howto.rst

@@ -11,35 +11,40 @@ All steps except those described in "Tag Release" should be performed on a
 server with a high-bandwidth connection to the Internet. About 1000MiB worth of
 data will be uploaded to PyPi.
 
-Tag Release
-===========
-
+Before Tagging Release
+======================
 - Update release notes, ``doc/whats_new.rst``.
 - Double check version number in ``pystan/__init__.py``
 - Update version in snippet in ``doc/getting_started.rst``, i.e., "wget ..."
 - Commit any changes you just made.
 - Double check that tests pass for this commit.
-- Fast-forward branch ``master`` to ``develop``.
-- Release documentation
 
-  - ``git rebase master readthedocs``
-  - ``git push --force origin readthedocs``
+Tag Release
+===========
 
+- Fast-forward branch ``master`` to ``develop``.
 - Tag and sign the release
 
-  - For example, ``git tag --sign v2.4.0.1``
+  - For example, ``git tag -u C3542448245BEC68F43070E4CCB669D9761F0CAC --sign v2.4.0.1``
   - Push tag to github ``git push --tags``
 
-Build source distribution
-=========================
+Update Documentation
+=====================
+
+*readthedocs needs a single patch to work.*
+
+- Release documentation
+
+  - ``git rebase master readthedocs``
+  - ``git push --force origin readthedocs``
+
+Build source distribution and wheels
+====================================
 
 Assemble source distribution::
 
     ./build_dist.sh
 
-Build Wheels
-============
-
 Linux and OSX: in the ``pystan-wheels`` repo update the ``pystan`` submodule
 and bump the version in ``.travis.yml``. Push changes.
 
@@ -49,9 +54,6 @@ wheels.
 When wheels have been created they will be automatically uploaded to a
 Rackspace storage bucket.
 
-Download Wheels
----------------
-
 After the wheels have finished building, download them from the Rackspace
 storage bucket.
 
@@ -75,8 +77,8 @@ Upload Source Distribution and Wheels to PyPI
 
 - Upload source distribution and wheels::
 
-    twine upload --skip-existing dist/*.tar.gz dist/*.tar.gz.asc
-    twine upload --skip-existing dist/*.whl dist/*.whl.asc
+    python3 -m twine upload --skip-existing dist/*.tar.gz dist/*.tar.gz.asc
+    python3 -m twine upload --skip-existing dist/*.whl dist/*.whl.asc
 
 If ``twine`` prompts for a username and password abort the process with
 Control-C and enter your PyPI credentials in ``$HOME/.pypirc``. (For more
@@ -97,6 +99,14 @@ Update Source
 - Add placeholder for next release in ``doc/whats_new.rst``.
 - Commit changes and push ``develop``.
 
+Update Conda-Forge
+------------------
+
+Update the repository at https://github.com/conda-forge/pystan-feedstock
+
+You will need the sha256 of the tarball. Calculate it by hand or find it at
+https://pypi.org/project/pystan/#files after uploading the tarball.
+
 Update Stan Website
 -------------------
 
@@ -108,19 +118,18 @@ number in the following file needs to be incremented::
 Make Release Announcement
 -------------------------
 
-Post a message to the stan-users mailing list. The following is an example from
+Post a message to the Stan discourse forum. The following is an example from
 PyStan 2.14.0.0 (subject is "pystan 2.14.0.0 released on PyPI")::
 
-    PyStan 2.14.0.0 is now available on PyPI. You may upgrade with
+    PyStan 2.17.0.0 is now available on PyPI. You may upgrade with
 
-         python -m pip install --upgrade pystan
+         python3 -m pip install --upgrade pystan
 
     A list of changes is available in the customary location:
 
     http://pystan.readthedocs.io/en/latest/whats_new.html
 
-
 TODO
 ====
 
-- Automate this entire process.
+- Automate more of this process.