Awesome API Design

on YouTube ↗22m

" summary

Shows concrete C and C++ examples: renaming malloc/mfree for symmetry, the std::vector empty vs clear confusion and a checked vs unchecked index design, and arguing for safe by default with not_discard annotations. Recommends a C ABI facade with an internal C++ party API (the Mullet) so binaries stay stable while implementation evolves, and a layered “Domain Burger” separating tech APIs from domain verbs. Emphasizes naming, parameter ordering, predictability, and fluid types with actionable changes to make existing APIs less surprising.

AI-written summary · about

" chapters (9)

1. 0:00API design principles
2. 1:10Memory allocation API
3. 5:50Consistency in API design
4. 7:36Symmetry in APIs
5. 10:25Type safety in APIs
6. 13:57Interface design
7. 15:02Mullet pattern
8. 18:36Domain burger pattern
9. 21:07Conclusion

" related talks

• 47mAPI Design PrinciplesJohn Pavan · CppNorth 2023
• 01h 06mGood API designAlex Martelli · EuroPython 2011
• 01h 36mThe Most Important API Design Guideline - No, It's Not That OneJody Hagins · C++Now 2024
• 01h 18mAPI design: Lessons LearnedRaymond Hettinger · EuroPython 2011
• 01h 28mFrom Template Metaprogramming to User Convenience - API Design StoriesRuslan Arutyunyan · C++Now 2026
• 56mEfficient and Reliable Wrapping of C APIs Using Modern C++Vladimir Vishnevskii · C++ on Sea 2023
• 01h 06mGood API designAlex Martelli · EuroPython 2011
• 42mGood APIs don't need a tutorialAlec Strong · droidcon NYC 2019