sphinx-apidoc now generates module docs
Update docs to work better with sphinx-apidoc

Generally, this means removing module name headings, as apidoc already does that.
While I was in here, I also opportunistically linted and clarified some things
Move examples into their respective docstrings

a.k.a. "The one that psav might not like"

Having separate sections for the examples, particulary where the example
wasn't on the same page as the code documentation (accordion, toolbar),
isn't as handy as having the usage right next to the signature, and
Args/Returns/Raises blocks. This was made comical by using the
sphinx-apidoc generator.
Merge pull request #306 from seandst/docs-docs

Docs craziness...