https://www.hillelwayne.com/post/what-comments/ #codeclarity #programmingdebate #codingbestpractices #HackerNews #ngated
Maybe Comments SHOULD Explain 'What'
People say âComments should explain why, not what.â I feel like starting a flame war today so Iâm going to argue that comments should explain âwhatâ too. Please donât use this as justification to write bad code, okay? Okay. First of all, why shouldnât comments explain âwhatâ? If you need comments to explain whatâs going on, it suggests your code is unclear. If I write //weight, radius, price w = 10, r = 9, p = 1 Thatâs not as clear as saying



