document incoming changes