polishing [ci skip]

fix typos, spacing and broken links
Merge pull request #2634 from SergioCrisostomo/polish

small cleaning, updating and polishing