some updates to the README for clarity