Support examples and returns in swagger

Look into things like

* example values of parameters
* document returns

See https://sphinx-rtd-tutorial.readthedocs.io/en/latest/docstrings.html for docstring options