Fix rst formatting which was producing a syntax error in the page + minor English polishing.