3 ms·
You beat me to the "self documenting code" thing by 10 minutes! I never bought in to the whole "clear code doesn't require comments" belief, mainly because the
by codelikeawolf 5y ago
You beat me to the "self documenting code" thing by 10 minutes! I never bought in to the whole "clear code doesn't require comments" belief, mainly because the clearest function in the world can't provide details about its role as part of a larger system. Also, you sometimes just have to do weird stuff to get things to work (usually because they're out of your control). Rather than trying to retrace your steps every 6 months when you look at that code, a sentence or 2 describing its purpose gets you up to speed. I've been burned by zero comments way more times than I've been burned by incorrect comments.