Welcome to the API The Docs Podcast

Laura Vass, co-founder of the API The Docs conference series, hosts documentarians and other practitioners from all across the API world to discuss the latest topics, new learnings and best practices around API documentation and developer portals.

API The Docs podcast logo

The valuable problem: about Domain Driven Design with Luca Vettor

03 May, 2023

Business and technical personas may have different skills, and in many cases, they use different terminology. Luca Vettor (Information Architect at Deltatre) explained how Domain Driven Design and event storming create transparent communication between the two personas. What is induced and intrinsic complexity? How could we define the problem space when the customer is in a complex environment and their problems are intertwined? Luca Vettor helped us to answer these questions.

A love letter to technical writing – Interview with Fabrizio Ferri-Benedetti (Passo Uno)

12 April, 2023

 

Why did Fabrizio Ferri-Benedetti (Senior Staff Technical Writer at Splunk) write a love letter to technical writing? How could technical writers create a bridge between the different parts of a company? With an MSc in cognitive psychology, Fabrizio shares a nuanced perspective in his ‘Docs' hierarchy of priorities’ and associated metrics.

Docs-as-Code for better collaboration at Amadeus for Developers – Interview with Anna Tsolakou and Mathieu Pincovai

02 March, 2023

Anna Tsolakou (Developer Advocate) and Mathieu Pincovai (Customer Success Specialist) shared with us the journey on how Amadeus for Developers created consistent and clear documentation. We also talked about why the docs-as-code approach is so crucial for them, and how they can create the right documentation for their APIs.

Advocacy at Spotify for Developers - Interview with Serah Njambi Kiburu and Alvaro Navarro

14 February, 2023

Spotify Developer advocates Serah Njambi Kiburu and Alvaro Navarro talked with us about the two enemies of developer empathy, and their practices to optimise and scale for the community’s real needs. We also asked why Spotify even needs an API developer portal, and why isn’t it built on backstage? (spoiler alert) They have good reasons for that.

Typical patterns in the process of API learning – Interview with Emese Hallgató

25 October, 2022

Our guest Emese Hallgató works as a UX researcher at Pronovix Developer Portals. Her education and experience in computer programming and in psychological research open the door to better understanding developers and their needs. 

 

 

Techwriting, DX and DevRel working together at Miro - Part 2

30 September, 2022

In Part 2 of our conversation with Miro's DevRel Lead Anthony Roux and Senior Techwriters Mira Balani and Marco Spinello, we walk deeper into how their respective teams complement each other, and we will also get a detailed narrative from Anthony about their process to aggregate all types of feedback, whether it's a feature requests, bugs, or documentation improvements into one central base.