Changing docs to reflect on recent API change

This should have been done in #68, but we opted not to bother with the docs while the API is still changing. However triggered by #94,  I made a quick fix to the examples in the spirit of having no or minimal docs is still better than wrong docs.