Comment on I am God's greatest programmer
xmunk@sh.itjust.works 1 year agoThe best explanation I’ve ever heard is:
Comments should state the ‘Why’ never the ‘What’.
Comment on I am God's greatest programmer
xmunk@sh.itjust.works 1 year agoThe best explanation I’ve ever heard is:
Comments should state the ‘Why’ never the ‘What’.
hikaru755@feddit.de 1 year ago
There are some cases though where the code is just complicated for reasons outside of your control, in which case “what” comments are good - but they should never be taken at face value, but only used as a first step in understanding the code. There’s a significant risk of the code not actually doing what the comment says.