documenting the update process