README updates suggested by @dan-blanchard