The Signature Is the Contract

Before anyone reads the body,
they read the signature.

The name. The inputs. The output.
That's the promise.

If the promise is clear,
the function half-explains itself.

Vague names, sloppy types,
and the contract is a lie.

Spend time on the signature.
It's the part everyone reads first.

– Serguey Asael Shinder