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

APIs You Won't Hate

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