Improvements to readme in preparation for v1.2