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

There are no comments on this comment yet.