Commenting is good, people need to know the reasons for this design choice.