Gehen Sie mit der App Player FM offline!
Generating API Specs can be Painful, with Joel Clermont from Mastering Laravel
Manage episode 491899383 series 1942451
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
57 Episoden
Manage episode 491899383 series 1942451
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
57 Episoden
Alle Folgen
×Willkommen auf Player FM!
Player FM scannt gerade das Web nach Podcasts mit hoher Qualität, die du genießen kannst. Es ist die beste Podcast-App und funktioniert auf Android, iPhone und im Web. Melde dich an, um Abos geräteübergreifend zu synchronisieren.