Add release docs & remove automated publish to PyPI

We can add it back later if we wish - especially once we
get more packages into `contrib/`

Author: yuvipanda

.travis.yml

@@ -7,14 +7,4 @@ script:
   - pip3 install pytest
   - JUPYTER_TOKEN=secret jupyter-notebook --config=./tests/resources/jupyter_server_config.py &
   - sleep 5
-  - pytest
-
-deploy:
-  provider: pypi
-  user: nbserverproxy
-  password:
-    secure: R06qgVAIrQ9u4D/Z7aiELMGddZypeorBFZ5sj/u0IrrGmrxGekxgV1NtWTzuTBKDHrnBKewNQTKyrwrcdDeU09Q4RgbyBmctX7u1UUQQdLSYfpbIh30SshuP57EiqGOo4wPXHOzBDtQg0SWtTVWqJAogymT0s7m3MOcFzbbVCReIX1uMFiG6X7TWKMB72WFN65rEtDa/Myq4hMvKOgcf+MWGnZzqNdaKFs+BHxfEc7MsJB6NooxQchiBqs0nJ3rfLAKblIPVdRx9ErpaUR0Z+VBuML8Hs0KCJyKh+H9POEBonPp+cVN/sOmFy39tESKhKJ5KNjfBxr/1GS9de8HeFwxwbz4/BVmbCzpXdNpRTD08JUGhia2xda4L8I/wNWGuj/SC0Y80tJ2FmauPrF9eL0AE1VGfwhCoXa4LFClBrzKyFsld0Gr4+mekxBvYrPtswPuTd1hGhhjui0DH62QxRIdQvWT7wWMzvxSH1dROQAu2OhzLKH8v/S/UnstT74wqEmPldH0R5zDVM75viKPpijv4USt0XwjgUwdIPlO1rDK/aRBIqyEb2eAI9U3f0zhGi4PImLlc9hSfXmYLT1TOgU7X/A+I1eBuMBSwg5poZICELCcEYod9wKXP3Xx91hoAksWnFAwUA9yoeu5Tmx7cSXbruIbws8EZRCeeB/ROHRU=
-  on:
-    tags: true
-    repo: jupyterhub/nbserverproxy
-  distributions: sdist bdist_wheel
+  - pytest

docs/contributing/release.rst

@@ -0,0 +1,75 @@
+.. _contributing/release:
+
+================
+Making a release
+================
+
+We should release early & often, following `semver <https://semver.org/>`_ wherever possible.
+
+Packages in this repository
+===========================
+
+This repo has more than one package.
+
+#. The primary ``jupyter-server-proxy`` python package. This contains the actual proxying
+   code, and the classic notebook extension. This is published on `PyPI <https://pypi.org>`_.
+
+#. The JupyterLab plugin, ``jupyterlab-server-proxy``. This provides the launcher icons in
+   JupyterLab.
+
+#. Various python packages in ``contrib/``. These are convenience packages that help set up
+   a particular application for use - such as RStudio or Theia.
+
+We try to keep the version numbers of all these packages in sync, even when there are no
+changes. This keeps reasoning about versions simple.
+
+Gaining Access Privileges
+=========================
+
+Before making a release, you need access privileges for the following.
+
+#. Write access to the `GitHub repo <https://github.com/jupyterhub/jupyter-server-proxy>`_.
+
+#. Publish access to the various python packages on PyPI.
+
+#. Publish access to the JupyterLab plugin on `NPM <https://www.npmjs.com/>`_.
+
+Release checklist
+=================
+
+#. Update the package version number in ``setup.py``.
+
+#. Update the JupyterLab plugin's version to match, in ``jupyterlab-server-proxy/package.json``.
+   We keep these two versions in sync to avoid figuring out a matrix of 'which version of
+   the python package is compatible with which version of the JupyterLab plugin?'
+
+#. Commit these changes and make a pull request with it. 
+
+#. Once pull request is merged, make a tag of form ``v<version-number>``:
+
+   .. code::
+
+      git tag -a v<version-number>
+
+   And push it to the official repository
+
+   .. code::
+     
+      git push git@github.com:jupyterhub/jupyter-server-proxy --tags
+
+#. Publish the package on PyPI
+
+   .. code::
+
+      pip install twine
+      rm -rf dist/*
+      python3 setup.py sdist bdist_wheel
+      twine upload dist/*
+
+#. Publish the JupyterLab plugin on npm
+
+   .. code::
+
+      cd jupyterlab-server-proxy
+      npm publish
+

docs/index.rst

@@ -28,8 +28,19 @@ Contents
 ========
 
 .. toctree::
+   :maxdepth: 2
 
    install
    server-process
    launchers
-   arbitrary-ports
+   arbitrary-ports
+
+Contributing
+============
+
+Contributions of all kinds - documentation, issues, blog posts, code, are most welcome!
+
+.. toctree::
+   :maxdepth: 2
+
+   contributing/release