add a note about gen_changes