3 ms·
#8 and #9 contradict each other. If you're supposed to create an "interface", let's assume that's the public api. But if you're trying to make methods small e
by grandalf 17y ago
#8 and #9 contradict each other.
If you're supposed to create an "interface", let's assume that's the public api.
But if you're trying to make methods small enough that comments are not needed, you're doing so for implementation purposes, since chances are most of those methods will be private.
Personally, I think a few comments are nice, especially to help orient someone their first time reading the code.
If you're doing something so magical that it requires comments to have any hope of being understood, you should have a really good reason for using so much magic.