handle basic auth properly if passed in
[doc] add a basic readme
[doc] minor doc tweak