2 ms·

I feel like comments are extremely valuable in API documentation, but not so much in the implementation. When you're reading an API you want to understand how

I feel like comments are extremely valuable in API documentation, but not so much in the implementation. When you're reading an API you want to understand how it works without cracking open the source. When you're looking at an implementation it is your duty to load the source into your comprehension, at which point comments become irrelevant, or worse, misleading.

alkonaut 11y ago
Here is how much comments is actually needed: https://sourceware.org/git/gitweb.cgi?p=glibc.git;a=commitdiff;h=b995d95a5943785be3ab862b2d3276f3b4a22481 https://sourceware.org/git/gitweb.cgi?p=glibc.git;a=commitdi...