add some notes in comments