Episode
Better API docs, customer support lessons, and cannoli
- Published
- Jul 2, 2026
- Duration seconds
- 2702
- Processing state
not_requested- Canonical source
- https://share.transistor.fm/s/aa9c2d2e
Actions
POST https://stenobird.com/v1/public/podcasts/north-meets-south-web-podcast-706861/episodes/better-api-docs-customer-support-lessons-and-cannoli/transcription-requests
Idempotently request low-priority transcript generation for this episode.GET https://stenobird.com/podcast/north-meets-south-web-podcast-706861/better-api-docs-customer-support-lessons-and-cannoli.md
Read the agent-friendly Markdown representation of this episode resource.
Summary
Jake shares lessons from rebuilding a permissions system around flexible roles, temporary permission leases, and delegated user management. He also discusses adding Apple Pay and Google Pay, plus designing automated text-message payment flows that use numbered choices instead of complicated keywords. Michael talks about building lender integrations, the importance of adding real context to API documentation, and using Claude to turn JSON specifications into PHP DTOs and enums. He also reflects on his team’s new helpdesk rotation, where direct exposure to users has uncovered long-standing bugs, inefficient manual processes, and opportunities for developers to better understand the people using their software. They finish with the challenges of parenting teenagers, preparations for Laracon US in Boston, including a search for coffee, donuts, bagels, and cannoli. (00:00) - Club World Cup surprises and sports talk (03:12) - UFC, LeBron and basketball moves (06:33) - Rebuilding roles and permissions (08:39) - Permission leases and delegated management (10:02) - Apple Pay, Google Pay and text-based payments (11:50) - Lender integrations and better API documentation (14:08) - A new developer and the helpdesk rotation (17:13) - Automated tickets and failed queue jobs (18:54) - The address autocomplete bug (19:58) - When tiny code changes create hidden failures (23:02) - Why support requests need a real ticket (25:17) - Developers learning directly from customers (27:53) - Cross-department training and business context (30:51) - Building trust beyond Slack (32:02) - Weekly stress, workload and personal check-ins (35:18) - Parenting teenagers and setting curfews (37:10) - Planning for Laracon US in Boston (40:00) - Australian and American school calendars (42:51) - Vacations, PT…