a month ago
- APIs that initially impress often lead to later maintenance troubles; trust in longevity over initial elegance.
- The first version of an API is often overvalued because it's judged in a simple context before real-world dependencies emerge.
- Key API design issues relate to boundaries: deciding what's public vs. private early to avoid unintended dependencies.
- Expose as little as possible initially, as adding later is easier than removing after others rely on it.