Generating API Specs can be Painful, with Joel Clermont from Mastering Laravel
From APIs You Won't Hate by APIs You Won't Hate
July 1, 2025 · 28 min · Episode 49
About this episode
Phil Sturgeon discusses API development with Joel Clermont, focusing on the challenges of generating API specifications and the debate between code-first and design-first methodologies.
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 Clermont website - joelclermont.com github - @joelclermont Why I don't like generating API specs on Mastering Laravel OpenAPI Overlay spec on GitHub Use OpenAPI Overlays Today from APIs You Won't Hate Scramble for Laravel Creators & Guests Phil Sturgeon - Host Joel Clermont - Guest
People in this episode
Host: Phil Sturgeon
Guest: Joel Clermont
Topics covered
- API development
- code-first methodology
- design-first methodology
- API specifications
- documentation
- auto-generated specs
Keywords
- API specs
- Laravel
- documentation
- auto-generated specs
- code-first
- design-first
- API development
Mentioned in this episode
Organizations: Laravel, Mastering Laravel, OpenAPI, APIs You Won't Hate, joelclermont.com, GitHub
More episodes of APIs You Won't Hate
- Anvil is the Data Company that makes PDFs a breeze · April 2, 2026 · 30 min
- Supergood is building unofficial APIs for everything · March 16, 2026 · 29 min
- Building a Sustainable Future in APIs with Kin Lane · December 1, 2025 · 43 min
- All about Mocking, with Wiremock's Tom Akehurst · July 1, 2025 · 52 min
- Rails APIs and Clickfunnels with Rich Steinmetz · February 3, 2025 · 39 min
- Catching up with Phil, Mike, and Alexander · November 1, 2024 · 49 min
Explore listener stats, chart rankings, contacts and more on the APIs You Won't Hate podcast page.