updated notes, considering rework