Consider setting up readthedocs?

[zdexter]

The current documentation is not precise enough on which properties go on which objects, etc. This has led to confusion and several PRs. It seems like the following would resolve this:

1. Autogenerate API documentation from code
2. Put these autogenerated docs along with a) examples and b) a quickstart on readthedocs.org

What do people think about this?

[juriejan]

I don't think the docs are currently that bad, just a few ambiguities here and there, but there being ironed out by the community. That said, better docs are always, well, better. Let me know if I can help out.