document the changes that should be done