render class-level and __init__-level docstrings

[bmorris3]

Many packages across the Python scientific stack either set the following option in their conf.py

• sphinx-astropy

• matplotlib

or mimic this behavior in their docs (scipy example)

Here I set that option in docs/conf.py so the documentation that the template, and explain the alternatives in a comment.