some documentation tweaks and an added README