Some honest mistakes I've made designing APIs that other engineers had to use

An incomplete catalogue of API design decisions I’d take back if I could. Names that aged badly, abstractions that were exactly one level too clever, defaults that punished the people I most wanted to help, and a couple of cases where the right move was just to leave the boring thing boring.

Written in the spirit of “I wish someone had told me”.