maybe instead of this line, a snippet about the reasoning/logic behind the changes?