Re:JSON as configuration files: please don’t (2016)
by breck on Saturday April 13, 2019 @03:07PM
(#19655086)
Edit: adding a link to the Clean Code bit about comments, which I think is great advice : https://gist.github.com/wojteklu/73c6914cc446146b8b533c0988c...
[ Parent
| on HN ]
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...