Functions

Functions are the verbs of your system. The best ones are small, do exactly one thing, and read top-to-bottom like a story where each line hands off to the next. This file covers size, single responsibility, abstraction levels, arguments, side effects, and command-query separation.

Good functions lean hard on good names — see meaningful-names first. For how functions should signal failure, see error-handling.

Quick Reference