some notes and a bug fix