27 Jun
2013
27 Jun
'13
6:25 p.m.
Antoine Pitrou
I don't always find it easy to summarize a function in one line.
Difficulty in coming up with an accurate one-line summary of the intent of a function is a code smell: the function probably needs to be simplified so it is easier to describe accurately. This is, IMO, one of the primary benefits of having a convention of expecting a one-line summary for every function (and module and class). -- \ “Courage is not the absence of fear, but the decision that | `\ something else is more important than fear.” —Ambrose Redmoon | _o__) | Ben Finney