fix some typos and styles,, add notes