← Back to context

Comment by barrkel

5 years ago

Function names are comments, and have similar failure modes.

Comments that are limited to only a 2 or 3 dozen characters at most, so worse than comments ime.

  • You can put your prose at the top of the function if you really need to explain it more. :)

But it's easier to notice they're outdated, because you don't see them only when looking at the implementation.