improve/update comments and markdown in prep for v0.1.0 release
update links to github repo