more documentation work
ugh... typo in all the examples
update change log and bump up the project version
merge
update docs for 0.1.6