“A common fallacy is to assume authors of incomprehensible code will be able to express themselves clearly in comments.” - Kevlin Henney

@CodeWisdom code comments document the author's aspirations at some random point in time, and need not reflect what the code is actually doing ... EVER

@CodeWisdom This statement assumes a rigid two-step process. Many times I've seen docs illuminate unstated architecture and trigger a cleaner re-design.

@CodeWisdom is qa coach

@CodeWisdom @GergovPavlin Let's hope so :D

@CodeWisdom Applicable to all areas of life also.