Re:Douglas Crockford: Why I removed comments from JSON
by nirvdrum on Tuesday May 01, 2012 @10:35AM
(#3914496)
I'm not refuting the value of documentation, I'm just acknowledging the referential integrity issues with it. All too frequently I've encountered cases where a config file gets updated but the wiki doesn't. Since all configuration files are version-controlled, I never run into a situation where a file changes and I don't know why (well, discounting bad commit messages). But, a documented wiki wouldn't help in that case anyway. A comment is documentation too ...
[ Parent
| on HN ]
There are no comments on this comment yet.