Fixing a few links as the original ones were returning 404.
The commit fixes .rst syntax issues to make the pages
render "nicer". The commit changes only format of the .rst
code, the content of the pages is not changed at all.
Change-Id: Icf0da2d7d1b42b065639c9105fbc16e1999bf630