Use sphinx directives to describe function and class names [ci skip] (#299)

In a future PR we should replace some of these `..method`s with `..automethod`s, and similar for classes and functions.

We use `:noindex:` to prevent clashes with the api documentation in `api.rst`, which is generated with autodoc.

Author: eric-wieser