Tweaks to README.md to allow pandoc to provide a valid .rst
Update generated .rst