4 ms·
I don't understand. doesn't commenting ruin the whole point of a human readable format? If you have to add comments, it means you need to communicate something
by sickbeard 11y ago
I don't understand. doesn't commenting ruin the whole point of a human readable format? If you have to add comments, it means you need to communicate something that can be done in more concise way.
- baq 11y agowhat? comments are the most important factor of 'human-readability' by far. without them you can't e.g. explain what a particular key does, what is it's default value (if any), or perhaps the most important thing - you can't even put a link to the documation!
- sickbeard 11y agowhat does 'human-readability' mean? JSON is data-transmission format that is human readable.. which is why it happens to be more popular than XML (or SOAP) because you can read the data and see the data. It's not meant to transmit context (i.e. it's useless and that's what documentation is for).