made the library less opinionated and cleaned up the example
making the library properly opinionated

bumped the minor version number;
minor example updates