https://www.hillelwayne.com/tags/halfbakery/ Recent content in Halfbakery on Hillel Wayne Hugo -- gohugo.io en-us Tue, 05 Dec 2017 00:40:32 -0600 https://www.hillelwayne.com/post/what-comments/ Tue, 05 Dec 2017 00:40:32 -0600 https://www.hillelwayne.com/post/what-comments/ 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