a few minor updates from the notes document