updated notes and markup