small fixes to user-guide/index
Tweaks to README.rst, and remove the old README