adapt documentation to the update functionality