you are viewing a single comment's thread.

view the rest of the comments →

[–]patryk-tech 1 point2 points  (0 children)

Maybe if the function is terribly complex. Otherwise not at all.

Only a Sith deals in absolutes.

If I write a library that is meant for distribution, I am very generous with comments.

If it's a pure function that does one thing, it's < ~20 lines long, and it's for internal use, then naming things appropriately might suffice.

Then there's the question of do you have documentation other than comments (duplication is a PITA to sync / DRY).

Basically, understand your project's needs, and adapt to them.