document the changes