update notes and terminology