Document release process

Author: stsewd

Makefile

@@ -1,6 +1,10 @@
 release: clean
+	git checkout master
+	git pull origin master
 	python setup.py sdist bdist_wheel
 	python -m twine upload dist/*
+	git tag `python -c "print(__import__('sphinx_search').__version__)"`
+	git push --tags
 
 clean:
 	rm -rf dist/

docs/development.rst

@@ -22,3 +22,22 @@ Generate minified JS and CSS files via ``Gulp``:
 
 Run the test suite with ``tox``. More information about testing is
 available at :doc:`Testing page <testing>`.
+
+Releasing
+---------
+
+Make sure you have the latest version of these packages:
+
+.. code-block:: bash
+
+   python -m pip install --upgrade setuptools wheel twine
+
+Update the version in ``sphinx_search/__init__.py``,
+and run ``make release``, this will:
+
+- Checkout and update your master branch.
+- Generate the distribution archives in ``dist/``.
+- Upload the archives from ``dist/`` to PyPI.
+- Create a tag from ``__version__`` and push it to GitHub.
+
+.. note:: Make sure you don't have any uncommitted changes before releasing.