Wow, I can't believe these comments. I give. HN is stupid. Programmers are by and large stupid, we just have a set of specialized skills.

I'm starting to understand now why so much code is documented so poorly.

And yet, there's smart posts like these that give me some glimmer of hope. Thanks for stemming the tide. I hope those of us not totally brain dead can figure something out.