@[email protected] to Programmer [email protected] • 1 year agoadvisediscuss.tchncs.deimagemessage-square33fedilinkarrow-up1658arrow-down19
arrow-up1649arrow-down1imageadvisediscuss.tchncs.de@[email protected] to Programmer [email protected] • 1 year agomessage-square33fedilink
minus-square@[email protected]linkfedilink31•1 year agoHot take: Even these ‘useless’ comments help, since they relieve you of the burden of reading the code itself, even if it’s trivial. One line of English is easier to parse than one line of trivial code.
minus-square@szniolink16•1 year agoYep. But reading one outdated line of English is worse than reading 5 lines of code and seeing the true picture.
minus-squarepizzaboilinkfedilink8•1 year agoOr, if you’re my manager, there’s just one comment at the top that says “for pizza”
minus-square@[email protected]linkfedilinkEnglish1•1 year agoI don’t feel like “ditch comments” is the right solution to “we {forget, don’t care enough} to update comments”.
minus-square@[email protected]linkfedilink3•1 year agoExactly! Maybe i’ve never seen a Pizza Box before. For you your code may be trivial. But for someone else an “open before eating” helps a lot.
Hot take: Even these ‘useless’ comments help, since they relieve you of the burden of reading the code itself, even if it’s trivial. One line of English is easier to parse than one line of trivial code.
Yep.
But reading one outdated line of English is worse than reading 5 lines of code and seeing the true picture.
Or, if you’re my manager, there’s just one comment at the top that says “for pizza”
I don’t feel like “ditch comments” is the right solution to “we {forget, don’t care enough} to update comments”.
Exactly! Maybe i’ve never seen a Pizza Box before. For you your code may be trivial. But for someone else an “open before eating” helps a lot.