fix typo and add some notes