Try using sphinx' automodule feature

...to include documentation at the source.
Instead of (or in addition to) having to write it separately.

I like how this works because you can include documentation for things as you write it, instead of having to go back and separately write documentation for the module.

As you can see, the .rst file becomes really simple.

If people like the look of how this works, I can continue this for the rest of public facing modules.