python packagisation: Take APIs to document from stbt.__all__

Instead of maintaining the list in 2 places. The documentation is now
sorted alphabetically instead of thematically, but I think that's
appropriate for reference documentation -- the man page isn't a tutorial.

I had to add a docstring to `ConfigurationError` so that it would
display correctly in the generated file.