update notes to make them clearer