[derdi]

Once, during an especially tedious review session, I told my agent something like "comments are not meant to demonstrate how well you understand the system, they are meant to help others understand the system". It felt like that helped.

[zparky]

that sounds like a good idea to try, thanks!