add a section based on Nics feedback; fix some typos