API The Docs Podcast

Streamline release notes: balance AI and human oversight

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.

Beyond Access Control: Model-Context Protocol Paradigm

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 safely enable its use. MCP and Large Language Models (LLMs) are changing paradigms from simple access control (previously focused on preventing access to the wrong information) to managing and bridging context between different systems, such as a workflow for example between  a corporate context and a remote context.

State of the Docs 2025: Insights from GitBook - Discussion with Addison Schultz

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 discoverability for users, underscoring the ongoing innovation in the field.  Bio: Addison Schultz is a web developer & designer working and living in Tokyo, Japan. He leads the developer relations team at GitBook, a tool for technical teams to document their products and APIs. He's been working the last 7 years on collaborative tooling, worked with some of the world’s leading design and development companies, providing product teams with advice and industry advice on how teams can build better products, faster. References:  https://www.stateofdocs.com/2025/ [https://www.stateofdocs.com/2025/] https://gitbook.com/docs/ [https://gitbook.com/docs/] https://apithedocs.org/ai-docs-online-2025 [https://apithedocs.org/ai-docs-online-2025 ]

How AI Impacts Technical Writing Workflows - Discussion with Anila Zaidi and Marco Spinello

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 [http://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 also touching on the challenges and ethical considerations surrounding AI.

Documentation by humans for humans - Discussion with Polina Zaichkina and Max Clayton Clowes

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 documentation and achieving internal enablement.