Documentation is out of date

[sb10]

The README.md is no longer reflective of changes that seem to have been made in the past few days. I can see the pull request that was merged suggests a "massive refactor"... it would be quite useful to know what has actually changed and how to update my code.

[grafov]

Sure. I will increment major version and push a new release asap. Docs and examples will be updated.