update docs with info about change events