Formal documentation for API

[ppbrown]

having examples is nice...
but what would be even nicer, is having an official documentation of the API?
Most other major python libraries I've used, have proper API documentation.

For example, I'd like to know how I'm expected to check if a
client.publish()

call failed or not.

I've noticed that if the connection is closed, something randomly writes to terminal,
[TRYING WRITE TO CLOSED SOCKET]

but I dont want things randomly writing to my terminal: I want my program to be able to detect the failed write, and do something sensible about it.

[Lenka42]

@ppbrown agree 🙂
I will try to find time for this during august.