Updates to README following conversation with bmuller.