How to design good APIs

https://blog.sbensu.com/posts/2022-01-24-apis-as-ladders/

People don't want to learn your API, so think of it as a ladder:

  1. Maximize the problems experts can solve.
  2. Minimize how much a novice needs to learn when they take their first step.
  3. Make a smooth ladder between their first and last step.

https://twitter.com/sebasbensu/status/1490452318818426880