[doc] Updated README.md with upcoming changes to API.
[api breaking] Change flow-control and arguments propagation dramatically. See README.md in previous commit.
[dist] Updated examples to be simpler.