Minor README updates ported back from the work in progress on the documentation site