fixed dead link, typos, and commenting issue