add note to changes, expand comment