If you do the normal, please do not comment your code. If you did the strange, please explain it briefly, but maintainably.

If something is broken, link to something outside the code (aka, vendor bug).