general review and cleanup of README