Generating API Specs can be Painful, with Joel Clermont from Mastering Laravel
APIs You Won't Hate · APIs You Won't Hate
Audio is streamed directly from the publisher (media.transistor.fm) as published in their RSS feed. Play Podcasts does not host this file. Rights-holders can request removal through the copyright & takedown page.
Show Notes
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