add some notes to broken code