small edits to notes and comments