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 updating the rest of public facing modules in this style [where it makes sense].