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.
Please don't use `import *`, but explicitly list the things you want to use into your namespace.
IMO this is actually much simpler to understand for users if they see where things are coming from, so `import *` shouldn't be used in docs.