updates readme documentation
tweaks based on suggestions