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 Clermontwebsite - 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
More from APIs You Won't Hate
Docsalot founder Faizan Khan sits down with APIs You Won't Hate host Mike Bifulco to talk about helping devs automate and build better docs for their products... and more! Docsalot - Agent-readable docs, for developers and AI agentsDocsalot on GitHub Docsalot on LinkedIn
Podcast host Mike talks to Tessa and Steve from Tabstack about building an API that gives standalone models access to the web. Tessa - https://x.com/tessak22 Steve - https://x.com/JustSteveKing Tabstack - https://tabstack.ai/ Steve's PHP Library for Tabstack - https://github.com/JustSteveKing/tabstack
Mang-Git Ng on LinkedIn: https://www.linkedin.com/in/manggit/ Anvil - https://www.useanvil.com/ Anvil on GitHub - https://github.com/anvilco Anvil on YouTube - https://www.youtube.com/@useanvil Anvil on TikTok - https://www.tiktok.com/@useanvil Anvile on Insta - https://www.instagram.com/useanvil/ spectaql - docs generation: https://github.com/anvilco/spectaql Anvil is Hiring: Wellfound/Angellist: https://wellfound.com/company/useanvil Build vs Buy Podcast: https://open.spotify.com/show/68VESxJNOw2GDP8Lcq8bdw?si=e5d3927f742744aa
Supergood.ai - Unofficial APIs, officially maintained Supergood on github Alex Klarfeld on [email protected]
Kin Lane - personal website API Evangelist Kin on GitHub Kin on Socials: Bluesky Mastodon LinkedIn Check out Kin's Podcast, API Evangelist Conversations (Spotify & Apple Podcasts) Creators & Guests