News for hackers. Stuff that matters.
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...
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...