Constructors are described more clearly and return values on error situations more compehensively. Also add an example of the object iteration protocol.
To build the documentation, invoke
sphinx-build . .build/html
in this directory. Then point your browser to .build/html/index.html.