Sphinx-RTD-Tutorial issues

Update build-the-docs.rst (.rts -> .rst)

little cosmetics, mainly fix .rts to .rts

Fix docstring syntax of optional parameters

1

I noticed a problem with the syntax of optional parameters (#9) and suggested to remove them from the tutorial. This PR does exactly that. Since the html build was changed...

timobrembeck

Example uses bluepy .. bluepy is not multi-platform ...

1

... This makes it difficult for someone not on Linux (say on a Mac) to follow the tutorial.

cognitiaclaeves

Fix sphinx-config.rst: a few words about enabling the `autodoc` extension

Just enabling `sys.path.insert(0, os.path.abspath('../../simpleble/'))` isn't enough for the `autodoc` extension to work: the extension itself has to be enabled first.

wolneykien

Sort dirs first and reword a bit

abitrolly

Syntax for optional parameters not correct

In [your tutorial](https://sphinx-rtd-tutorial.readthedocs.io/en/latest/docstrings.html#the-sphinx-docstring-format), you suggest using `, optional` after the parameter type to denote that a parameter is optional. However, according to the following sources, this is not the official...

timobrembeck

Enabeling "sphinx.ext.autodoc" is missing from sphinx-config.rst

2

As far as I can see, the tutorial does not include instructions on how to enable the autodoc extension for Sphinx in the first place. The file `conf.py` has to...

tcmetzger