4 ms·
I agree, and consider code without comments to be unfinished work, but writing code without comments is not the thrust of this article. It's just writing clear
by veidr 8y ago
I agree, and consider code without comments to be unfinished work, but writing code without comments is not the thrust of this article.
It's just writing clearer code, structured to make more things utterly obvious (to the human, but in many cases also to the compiler).
Code written like this will still need some comments/documentation, but it won't need as much because more things will be completely obvious.
- markrages 8y agoYou 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).