|
|
|
|
|
by phailhaus
1119 days ago
|
|
This is really cool, but somewhat misses the point of comments. If the comments can be generated from the code, then they are just restating what the code is doing. That's great for docstrings! But code comments are far more useful when they explain to you why the code is a certain way. That is something that is learned by the person implementing the code, and can't be learned by looking at it directly. For example, "Uses a generator here to avoid fetching all results into memory". |
|