The README file contains a lot of code examples, which tend to get outdated pretty quickly as the API is still undergoing some changes.

It would be nice to keep these code samples in the project codebase (in an examples folder...?), have them all properly unit-tested and dynamically included into the documentation - not necessarily into the README file - so we are sure all of them are always up-to-date.