Generating API Specs can be Painful, with Joel Clermont from Mastering Laravel

01/07/2025 27 min Episodio 49
Generating API Specs can be Painful, with Joel Clermont from Mastering Laravel

Listen "Generating API Specs can be Painful, with Joel Clermont from Mastering Laravel"

Episode Synopsis


In this episode of 'APIs You Won't Hate', the Phil discusses API development with Joel Clermont, a prominent member of the Laravel PHP community. They explore different approaches to building APIs, focusing particularly on the debate between code-first and design-first methodologies. Joel shares his experiences and challenges with generating API specifications and expresses his preference for manually writing specs. They also touch on challenges related to auto-generated specs, including the risk of drift between code and documentation. Various tools and strategies for improving API spec accuracy and integration are discussed, highlighting the importance of planning and thorough documentation in API development.Joel Clermontwebsite - joelclermont.comgithub - @joelclermontWhy I don't like generating API specs on Mastering LaravelOpenAPI Overlay spec on GitHubUse OpenAPI Overlays Today from APIs You Won't HateScramble for LaravelCreators & Guests

Phil Sturgeon - Host
Joel Clermont - Guest

More episodes of the podcast APIs You Won't Hate