3 ms·
Good code is legible and may not have a lot of comments at all, but the comments that are there add value. And honestly, what codebase doesn't have these:
by Freak_NL 9y ago
Good code is legible and may not have a lot of comments at all, but the comments that are there add value.
And honestly, what codebase doesn't have these:
// This looks weird and redundant, but is necessary because of a
// sneaky bug in libbar (libbar issue tracker #123) that might be
// fixed in their upcoming 2.0 release. Without it a race condition
// can occur at seemingly random intervals. See our issue tracker
// #456 for the whole nasty story.
barProvider.fertilizeFoos(null);
No amount of code is going to convey the same crucial information.
And yes, a professional programmer will maintain that piece of documentation.