fix bad links & improve wording.