fix a few typos and add some clarity