The thing that is most-often missing in the comments, and that you can't figure out just by looking at the code, is the why. I can eventually figure out what the code does, but that is only half the story. When the other half is missing, later viewers/editors of that code struggle. :-(
(no subject)
(no subject)
This. So very much this. I want to know the why.