minor doc changes to README and examples.rst