some notes and cleanups to README.rst