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

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

You can listen to Generating API Specs can be Painful, with Joel Clermont from Mastering Laravel online on Radio and Podcast. Open the player on this page to stream the available audio.

Generating API Specs can be Painful, with Joel Clermont from Mastering Laravel is an episode from APIs You Won't Hate by APIs You Won't Hate, LLC.

This episode is 27:35 long.

This episode was published on Jul 1, 2025.

Yes. Use the heart button on the episode page to add it to your favorite episodes list.

Yes. This page shows related episodes from APIs You Won't Hate when more episodes are available from the podcast feed.