version number bumped. tests updated. add some inline notes.
Merge branch 'release/v0.1.1' into develop