updated method comments
accounted for nil new_notes (fixed tests)