
Sign up to save your podcasts
Or


Episode 8 of The Developer Tools Podcast dives into why most API documentation fails developers on first contact. Lucas and Luna examine real docs from Twilio and LaunchDarkly, breaking down why traditional 'reference-first' docs lose readers and how 'task-oriented' design changes outcomes. They discuss the psychology of developer onboarding, the cost of unclear error messages in documentation, and why a single well-written example can reduce support tickets by 30 percent. Lucas cites a 2025 study from the User Documentation Institute showing that developers spend an average of 17 minutes hunting for a working snippet before giving up. Luna pushes back on whether documentation can ever replace a good sandbox environment. The episode closes with a reflection on how doc quality affects a product's perceived reliability. No ads, listener supported via buy me a coffee dot com slash fexingo.
#APIDocumentation #DeveloperExperience #Twilio #LaunchDarkly #TechnicalWriting #DeveloperTools #DevDocs #Onboarding #TaskOrientedDesign #UserDocumentation #APIUsability #SupportTickets #FexingoBusiness #BusinessPodcast #BusinessAndTechnology #LucasAndLuna #SoftwareEngineering #DevEx
Keep every episode free: buymeacoffee.com/fexingo
By FexingoEpisode 8 of The Developer Tools Podcast dives into why most API documentation fails developers on first contact. Lucas and Luna examine real docs from Twilio and LaunchDarkly, breaking down why traditional 'reference-first' docs lose readers and how 'task-oriented' design changes outcomes. They discuss the psychology of developer onboarding, the cost of unclear error messages in documentation, and why a single well-written example can reduce support tickets by 30 percent. Lucas cites a 2025 study from the User Documentation Institute showing that developers spend an average of 17 minutes hunting for a working snippet before giving up. Luna pushes back on whether documentation can ever replace a good sandbox environment. The episode closes with a reflection on how doc quality affects a product's perceived reliability. No ads, listener supported via buy me a coffee dot com slash fexingo.
#APIDocumentation #DeveloperExperience #Twilio #LaunchDarkly #TechnicalWriting #DeveloperTools #DevDocs #Onboarding #TaskOrientedDesign #UserDocumentation #APIUsability #SupportTickets #FexingoBusiness #BusinessPodcast #BusinessAndTechnology #LucasAndLuna #SoftwareEngineering #DevEx
Keep every episode free: buymeacoffee.com/fexingo