CONTRIBUTING: Separate subsections

Author: mgeier

CONTRIBUTING.rst

@@ -1,30 +1,28 @@
 Contributing
-------------
+============
 
 If you find bugs, errors, omissions or other things that need improvement,
 please create an issue or a pull request at
 https://github.com/spatialaudio/python-sounddevice/.
 Contributions are always welcome!
 
+
+Development Installation
+------------------------
+
 Instead of pip-installing the latest release from PyPI_, you should get the
-newest development version from Github_::
+newest development version (a.k.a. "master") from Github_::
 
    git clone --recursive https://github.com/spatialaudio/python-sounddevice.git
    cd python-sounddevice
-   python3 setup.py develop --user
+   python3 -m pip install -e . --user
 
 .. _PyPI: https://pypi.org/project/sounddevice/
 .. _Github: https://github.com/spatialaudio/python-sounddevice/
 
 This way, your installation always stays up-to-date, even if you pull new
 changes from the Github repository.
 
-If you prefer, you can also replace the last command with::
-
-   python3 -m pip install --user -e .
-
-... where ``-e`` stands for ``--editable``.
-
 Whenever the file ``sounddevice_build.py`` changes (either because you edited it
 or it was updated by pulling from Github or switching branches), you have to run
 the last command again.
@@ -35,13 +33,17 @@ If not, you can get the submodule with::
 
    git submodule update --init
 
+
+Building the Documentation
+--------------------------
+
 If you make changes to the documentation, you can locally re-create the HTML
 pages using Sphinx_.
 You can install it and a few other necessary packages with::
 
    python3 -m pip install -r doc/requirements.txt --user
 
-To create the HTML pages, use::
+To (re-)build the HTML files, use::
 
    python3 setup.py build_sphinx