Add some documentation on what this function is updating and why.