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

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

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

Listen for free

View show details

About this listen

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

What listeners say about Generating API Specs can be Painful, with Joel Clermont from Mastering Laravel

Average Customer Ratings

Reviews - Please select the tabs below to change the source of reviews.

Audible.com.au reviews

Amazon Reviews
No Reviews are Available
In the spirit of reconciliation, Audible acknowledges the Traditional Custodians of country throughout Australia and their connections to land, sea and community. We pay our respect to their elders past and present and extend that respect to all Aboriginal and Torres Strait Islander peoples today.