Damian, 7 principles of Better API Design
- Do one thing, really well
- Design by coding
- Evolve by subtraction
- Declarative beats imperative
- Preserve the metadata
- Leverage the familiar
- The best code is no code at all
Sometimes the magic is an explicit subroutine.
Just because something is trival doesn't mean it's not important.
Don't say "intuitive" or "DWIM", use "magic."