Update the sphinx extension to add method definition in the docs. This
makes the documentation a bit more usable.

Hide attributes that should not have been exposed. They still exist in
the code but their documentation doesn't make much sense.

Provide a sphinx extension that parses the required/optioanl attributes
and add infoo to the class docstring.