2 ms·
> Only "brilliant" code ends up needing comments. Often you have horrible complexity imposed on you from outside -- business rules you're implementing, etc, wh
by gknoy 9y ago
> Only "brilliant" code ends up needing comments.
Often you have horrible complexity imposed on you from outside -- business rules you're implementing, etc, which are _not simple_. You can write code that encapsulates a lot of that, and even refactor it so you can see _what_ the code is doing pretty easily ... but it's often _very_ valuable to document in a code comment (docstring, JSdoc, etc) WHY it's like that.
Arguably, the comment is not to explain the code, in this case, but rather to explain the twisted bureaucratic logic you're having to implement, so maybe that still counts as "brilliant" code. ;)