API The Docs Podcast

Our guests talk about their insights and experience as documentarians. We bring advice from behind open and closed developer portals, ideas on what new learnings you can aim for, and recent experiments from the field of API documentation.
 

API The Docs Podcast

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. 

 

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

07 September, 2022

With our three Mironeer guests, DevRel Lead Anthony Roux and Senior Techwriters Mira Balani and Marco Spinello, we talked about how they joined their teams, what they have learnt since, how and by whom their developer docs came to be as they are today, and what two documentarians are to do if they disagree. 

 

Interview with Anthony Sansone, staff technical writer at MongoDB - The importance of onboarding

06 July, 2022

Our guest is Anthony Sansone, staff technical writer at MongoDB, who has spent 20+ years in computer hardware, software, and services, specializing in data protection and user security. His experience ranges from startups to large multinational companies. In this episode, Anthony shares his insights about the techwriters’ onboarding and the inspiration you can get from new hires.

Interview with Marc Burgauer part 2 - Will social practices eat your change strategy for breakfast?

13 June, 2022

Or, maybe you could map it: what does each of you do, why, and how? We converse about integration of practices and practice networks with Marc Burgauer, co-founder of Contextualise. Together with Chris McDermott, they assist large organizations in their transformation efforts through maturity mapping. We are teasing out our ideas on how can the understanding of social practice theory–and the acceptance of complexity–possibly help write better technical documentation. How can we better ease and inform the users of the docs into the context in which the artifact operates? What would be the minimum shared vocabulary and methods to change anything for the better in a persistent, self-stabilizing socio-technical system–our workplace–and do we need to name practice theory at all for it?

Interview with Marc Burgauer part 1 - Will social practices eat your change strategy for breakfast?

13 June, 2022

We converse about integration of practices and practice networks with Marc Burgauer, co-founder of Contextualise. Together with Chris McDermott, they assist large organizations in their transformation efforts through maturity mapping.