Cows Look Like Maps@sh.itjust.works to Programmer Humor@programming.dev · 1 year agoBill is a pro grammersh.itjust.worksimagemessage-square97fedilinkarrow-up1796arrow-down196
arrow-up1700arrow-down1imageBill is a pro grammersh.itjust.worksCows Look Like Maps@sh.itjust.works to Programmer Humor@programming.dev · 1 year agomessage-square97fedilink
minus-squaremagic_lobster_party@kbin.sociallinkfedilinkarrow-up3·1 year agoI’ve seen it. That’s why I’m opposed to comments unless they really bring value (like explaining the why instead of the what).
minus-squareChickenLadyLovesLife@lemmy.worldlinkfedilinkEnglisharrow-up1·1 year ago I’ve seen it. OK, so let’s hear your story about how misleading comments caused a major (or even a minor) problem.
minus-squaremagic_lobster_party@kbin.sociallinkfedilinkarrow-up1·1 year agoOne example was when a method’s documentation said that it would throw a certain exception. Turns out it was actually throwing a different exception (deep into the code), so no wonder why we never captured it in time.
I’ve seen it. That’s why I’m opposed to comments unless they really bring value (like explaining the why instead of the what).
OK, so let’s hear your story about how misleading comments caused a major (or even a minor) problem.
One example was when a method’s documentation said that it would throw a certain exception. Turns out it was actually throwing a different exception (deep into the code), so no wonder why we never captured it in time.