can you comment on this update method as a bit of a docstring?