2 ms·
> Code doesn't lie, comments do Code doesn't tell the full story either. And code can contain bugs so one cannot fully trust the code too. If code/comments ar
by citrin_ru 4y ago
> Code doesn't lie, comments do
Code doesn't tell the full story either. And code can contain bugs so one cannot fully trust the code too.
If code/comments are out of sync it is likely that someone changed the code and forgot to update comments (which is possible to verify using VCS logs) or it may be that the comment stated the intention right but the code has a bug. Code+comments like a parity check to me - if they agree it is good, if not - I have to investigate if the comment or the code is correct.