[tengbretson]

If a function is only a few lines long its action should be entirely documented by its name.

[macintux]

The action, sure, but there’s more context than that in many cases. See my other comment.

https://news.ycombinator.com/item?id=18773167