fix minor documentation issues

fix formatting and a couple of links