3 ms·
You are conflating comments with documentation. Comments are low-level, documentation is high level. "self-documenting" removes the need for comments, not doc
by markrages 8y ago
You are conflating comments with documentation.
Comments are low-level, documentation is high level.
"self-documenting" removes the need for comments, not documentation. Ironically.
- veidr 8y agoI don't think "documentation" has such a narrow definition. There are various forms of documentation, from terse READMEs to formal specs. Comments in the code are just one of the many forms documentation can take (in some cases, the only one).