API The Docs Podcast

Tashfeen Mahmud, senior technical writer at Samsung Research in Canada explains why curiosity is your best defense against technical aversion, and how to prepare for a future where technical writers are primarily AI trainers. 'Adapting to AI isn't like learning to cook from scratch. It’s like walking into a kitchen that already knows how to cook: it just needs a human to guide it through t...

Senior technical writers Gareth Brinn and Lydia Pedersen talk about using GPTs and n8n to automate release notes: scripting, prompt engineering, and synthesizing data from Jira and GitHub. Next plans include using AI for first drafts of core docs while maintaining oversight. Their advice: start simple, iterate, and grow to achieve process improvements and strategic benefits.

API thought leader Kevin Swiber and Pronovix CEO Kristof Van Tomme join the podcast to explore the Model Context Protocol (MCP) and the emerging governance challenges it presents to API strategy. We discuss the need to balance driving business value and opportunity against mitigating the security risks associated with rapid MCP adoption, noting the pressure this technology puts on enterprises to s...

We discuss findings from GitBook's "State of the Docs" report (2025), for example that 90% view documentation as crucial for purchases, yet 40% of those interviewed don't track its performance. We talk of speeding up API integration, and GitBook's focus on refining adaptive and personalized documentation features, then address avoiding tunnel vision and keeping discoverabilit...

Welcome back to the A(P)I The Docs podcast! We’re opening this new chapter with an absolute treat of an episode in which Anila Zaidi, Staff Technical Writer at Squarespace, and Marco Spinello, Senior Technical Writer at Booking.com discuss the transformative role of generative AI in technical writing and beyond. We explore how AI has evolved from an experimental tool to an essential aid whilst als...

How do you get people on board when you shift to a new tool or a new approach? Even if the value proposition is clear, it might be a challenge to create a practice out of the change.  In this episode of API The Docs, Polina Zaichkina (Senior technical writer at Codat) and Max Clayton Cowes (Product director for experience at Codat) share insights about building a culture of participation around do...

In this episode, Naomi Pentrel and Andrew Feierabend share their journey of revamping Viam’s robotics APIs documentation. They discuss the benefits of sitting down with actual users in well-structured interview sessions with specific scripts and tasks. Learn about their approach to user research, their team’s collaborative methodology for achieving daily usability wins, mentoring, and implementing...

Byrne Reese had the opportunity to build a number of developer programs over the years. In this episode, he explains his unique Developer Pyramid framework which he uses as a guide to build a successful and scalable developer program now at RingCentral. He also dives into his passion for board games and how it influences his approach to documentation, and explores the Workflow Builder tool that re...

When it comes to learning Git, it can be daunting to navigate the plethora of learning resources out there. Recognising the need for a visually engaging all-levels experience, Anna Skoulikari (JetBrains) decided to write her own self-study book to help learners along the way.

"Key results are the things you're going to do to move that number. Here's the thing where most people spin out. There should be a break mechanism on the things that you're doing […] a culture of experimentation, and objective critique around 'Is this the right thing to be doing?” Welcome back to our two parts episode with Rachel Lee Nabors, we continue with talking about deve...

"You can always tell when it's a novice writer or a writer and an artist who are in bad relation because there will be blocks of text everywhere explaining how the character is feeling […] There's a delicate balance to be struck and it's the same with code.” Welcome Rachel Lee Nabors, one of the creators behind the grand award-winning react.dev portal where all 600+ code examples...

Drawing from her role as a wayfinder, Claire Waters (Senior Manager – Product Content Experience, Cloudflare) shares her team’s using the COIN methodology for embracing AI tools as a team, and how they engage in low-stakes AI challenges to foster familiarity and comfort with AI technologies.

You need docs and headspace when a well-oiled system inevitably throws a flat tire. With Dan Grabski we talked from car racing through tech execs mediating at Burning Man, forest fire incident management systems and early expectations setting all the way to API docs and back again.

Technical writers walk a tricky tightrope between delivering accurate technical information and making it comprehensible for a wide range of users with varying levels of technical experience. In this episode, Ryan Young (Technical writer at Stripe) shares his thoughts on bridging the gap between different content layers and writing for humans in a digital world.

How can one make their devportal accessible and useful at the same time? What can devportal owners do to support inclusive design? We were honored to ask Susanna Laurin (Certified Professional in Accessibility Core Competencies, G3ict and IAAP Representative to the EU) about these questions in 2023’s DevPortal Awards framework. As she highlighted, developer portals were a new field for her, and sh...

The API The Docs Podcast brings you a Special Edition series with insights from the 2023 DevPortal Awards.   Each year, the DevPortal Awards seeks the most outstanding solutions with the help of experienced jurors, who are volunteers with extensive knowledge of API programs, developer portals, and API documentation. In the Special Edition series, we share interviews with the jurors which were reco...

The API The Docs Podcast brings you a Special Edition series with insights from the 2023 DevPortal Awards.   Each year, the DevPortal Awards seeks the most outstanding solutions with the help of experienced jurors, who are volunteers with extensive knowledge of API programs, developer portals, and API documentation. In the Special Edition series, we share interviews with the jurors which were reco...

The API The Docs Podcast brings you a Special Edition series with insights from the 2023 DevPortal Awards.   Each year, the DevPortal Awards seeks the most outstanding solutions with the help of experienced jurors, who are volunteers with extensive knowledge of API programs, developer portals, and API documentation. In the Special Edition series, we share interviews with the jurors which were reco...

Connected to both customers and internal teams, customer success is a powerful source of valuable information throughout the entire feedback loop. In this episode, Charlie Edwards (Customer Success Manager at CAE Technologies Limited) explains how the feedback from customer success teams contributes to the comprehensive improvement of products. The API The Docs Podcast was brought to you by Pronov...

Adopting a beginner’s mindset allows you to explore familiar concepts through a lens of curiosity and openness. But how does that translate to documentation? In this episode, Adrienne Braganza Tacke (Sr. Developer Advocate & DevNet Community Programs Lead at Cisco) explains the unexpected benefits of writing with newcomers in mind and how it can take documentation to the next level.

How does a biological anthropologist become a professional docs auditor? Portia Burton, founder of DocumentWrite, narrates her meandering journey from biological anthropology to ESL China, through blockchain technology community engineering, all the way to content audit services. We talk about what to look for in an audit, and what is often critical for a successful content inventory [spoiler: spe...

Technical writing and developer relations are relatively new areas, and they have both grown out of a need for these specific skill sets. However, for newcomers in the IT landscape, it might take a while to understand what they actually mean and how they support the work of developers. Kruno Golubic (technical writer at Memgraph) and Katarina Šupe (DevRel at Memgraph) explain the benefits of a suc...

From rapid changes to learning on the fly, startups face unique challenges that require creative solutions. Alex Akimov (Head of API Platform at Monite) and Helen Kosova (API Technical Writer at Monite) discuss how Monite’s API council supports the adoption of an API-first approach at the company.

With Anthony Pichardo, product manager at Visa Developer Platform, on the value of user-centered design and building non-zero sum environments where everyone wins. Community is not just an afterthought, it’s an integral part of strategy. The platform team conducts regular user research to gauge pain points, and constantly strives to minimize the learning curve to better serve the community’s needs...

We explore how developer documentation hubs enable a unified information architecture, at least outwards: our guests Christoph Weber (Pronovix) and Kristof Van Tomme (Pronovix) talk about the nuanced, socio-technical nature of large scale documentation processes, the need for a central API docs team, and the future use of private LLMs.