Make the docs more readable

[auscompgeek]

Right now, the documentation for cscore._cscore is… not very palatable. We could do a much better job of formatting it.

• [x] Methods don't get the usual formatting treatment (i.e. they're not rendered indented).
• [x] The directives in objects.rst don't get the default py domain, so parameters look terrible.
• [ ] We could parse the type info from pybind11's signatures and output Sphinx type directives. (This one might be more difficult.)
• [ ] Rendered method signatures should not list the self argument.

[auscompgeek]

It looks like that second point is due to the first point. If you indent the contents of the docstring correctly, the directives will inherit the py domain of the block.

[auscompgeek]

Ah, our monkey-patching forgot to add the indent. Ha!