Re:JSON as configuration files: please don’t (2016)
by TeMPOraL on Saturday April 13, 2019 @04:08PM
(#19655447)
From the link, about comments:
Use as explanation of intent.
Use as clarification of code.
Use as warning of consequences.
Here's a link to a well-known recent book, half of which is pretty much about why those points are a real and frequent thing, and why code should be much more thoroughly commented than it's recommended by the usual philosophies.
https://www.amazon.com/Philosophy-Software-Design-John-Ouste...