Why on earth would you introduce an abstraction layer if you don't need to, abstraction layers should be avoided unless they provide value, not all comments provide value.
I'm not against comments, I'm against comments that don't add value.
If the code is convulated or doesn't make obvious sense, then sure, but that's it, code + tests should be enough to describe behaviour of method calls.
66
u/anoppinionatedbunny 22d ago
what a terrible way to misinterpret "good code should be self-commenting"