4 ms·
My golden rule is inline with javadoc being largly useless. Don't ever add SBO comments. SBO = Stating the Bleeding Obvious.
by teknopaul 5y ago
My golden rule is inline with javadoc being largly useless.
Don't ever add SBO comments.
SBO = Stating the Bleeding Obvious.
- benrbray 5y agoSometimes what is obvious to the code author won't be obvious to the person tasked with maintaining it. Sometimes, the "obvious" code has a bug, but its intended purpose is no longer obvious. Commends for "obvious" things add redundancy, like error-correcting codes.