add some notes. fix some typos