tweaks/docs
fixes
build
README clarifications and typofixes