@[email protected] to Programmer [email protected] • 2 years agoadvisediscuss.tchncs.deimagemessage-square33fedilinkarrow-up1658arrow-down19
arrow-up1649arrow-down1imageadvisediscuss.tchncs.de@[email protected] to Programmer [email protected] • 2 years agomessage-square33fedilink
minus-square@[email protected]linkfedilink31•2 years 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•2 years agoYep. But reading one outdated line of English is worse than reading 5 lines of code and seeing the true picture.
minus-squarepizzaboilinkfedilink8•2 years agoOr, if you’re my manager, there’s just one comment at the top that says “for pizza”
minus-square@[email protected]linkfedilinkEnglish1•2 years 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•2 years 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.