AI The Docs 2025
The year of agentic AI: Emerging practices in AI, documenting, and APIs
Online conference on June 24-25, 2025
Online conference on June 24-25, 2025
Last year, we learned that documentation is counterintuitively becoming even more critical in a world transformed by AI. No, you can't let an LLM write your docs–you can let it create drafts and maybe even hallucinate use cases–but without a verification process, documentation can't fulfill its ever-more-essential role as an enabler for affordance discovery (be it for humans or machines).
The AI community has declared 2025 the year of agentic AI. That is why, in 2025, we want to shine a spotlight on early use cases of agentic systems for creating and consuming documentation–designing, testing, and consuming APIs, and any other stories of practice on the intersection of AI, APIs, documentation, and developer portals.
Date: June 24-25, 2025, 2PM-7:30PM CEST
Learn how Michaela brings a product mindset to APIs in the heavy construction space, balancing governance, legacy, and customer value. Listen here »
What makes conversational AI trustworthy? Ronald stresses LLM constraints for reliability and the need for structured data. Tune in here »
Want to showcase your brand, tools, or thought leadership at the intersection of AI, API docs and developer experience? Check out the Sponsor Guide for options »
Rethinking web applications in the age of agentic AI: tools, spaces, and their affordances
All your docs are belong to us: from UX to DX to AX
Designing Software that Acts: Agents beyond LLMs
APIs at the Verge of AI
Breaking Developer Portal Silos How a Holistic Approach to UX and Tech Writing Drives AI Success
Breaking Developer Portal Silos How a Holistic Approach to UX and Tech Writing Drives AI Success
Lying to Robots: A Guide to Terrible API Docs (and what to do if you want to fix them)
From Overwhelmed to Optimized: How AI Can Boost Your Documentation Team
Smarter Search: How RAG Pipelines Help Navigate Complex Documentation
Beyond Style Guides: Using AI (and other things) to Automate Documentation Maintenance
Specs Are Docs Now: Designing OpenAPI for Agentic Interfaces
How LLMs are changing the way we build API specifications
How LLMs are changing the way we build API specifications
Specs Are Docs Now: Designing OpenAPI for Agentic Interfaces
Rethinking Docs as Code in the age of vibe coding
Leveraging AI for Efficient Technical Documentation and Routine Maintenance
The Robots are coming for your job, and that's okay.
AI-Assisted API Design and Documentation
The Robots are coming for your job, and that's okay.
Producing AI-friendly content: Emerging best practices
Self-Healing Docs: How Agents are Redefining the Docs Pipeline
Docs accessibility, for robots
From APIs to AI: How to Build an AI-Ready API Ecosystem
From APIs to AI: How to Build an AI-Ready API Ecosystem
API quick reference diagrams: boosting comprehension for both human and machine users
Effectively use AI Agents to Maintain Your Docs
How AI could leverage the DevPortal customer journey
Discoverability Is an Act of Agency: Rethinking Metadata as Cultural Infrastructure
Graph-Driven RAG AI Powered by DITA
Opening
KEYNOTE- Kristof Van Tomme (Pronovix) Rethinking web applications in the age of agentic AI: tools, spaces, and their affordances
Imagine how agentic AI will change the kind of interactions that users expect to have with web applications. What does this mean for the systems we use to create and publish business- and technical documentation? This keynote explores the evolving landscape, drawing on complexity theory, social practice theory, and emerging GenAI applications.
KEYNOTE - Ronald Ashri (OpenDialog.ai): Designing Software that Acts: Agents beyond LLMs
While LLMs have renewed interest in autonomous software agents, current implementations often overlook decades of foundational research. The end result is that we keep re-discovering the same problems while we could be leaping ahead. The aim of this talk to to bridge this gap by examining how established agent theories and architectures can enhance today's LLM-driven applications.
Olaf Stelter (Mercedes-Benz AG): How AI could leverage the DevPortal customer journey
AI solutions might improve the customer facing parts of a developer portal, but could also be used for background optimization. This talk shows examples and ideas we work on for Mercedes-Benz Data.
Roy Derks (IBM): Effectively use AI Agents to Maintain Your Docs
This session explores how to integrate AI agents into your workflows to ensure consistency, automate updates, and reduce manual effort. Learn best practices for handling diverse data sources and see real examples of how I'm using AI to keep my developer-focused documentation accurate and up to date.
Break (10 minutes)
David Karlsson (kapa.ai): Docs accessibility, for robots
Ever wonder if the writing tips you've been using all along work just as well for AI? Spoiler: They do. In this talk, we'll take a behind-the-scenes look at how AI systems consume your docs and how clear technical writing can streamline that process.
Kathleen De Roo, Ádám Balogh (Pronovix) - Breaking Developer Portal Silos How a Holistic Approach to UX and Tech Writing Drives AI Success
In this talk, UX and Techwriter specialists will explore how deep cross-functional collaboration builds stronger developer portals and prepares teams for the era of AI. You'll hear real examples of what works (and what doesn’t), and leave with practical steps to improve your portal, your teamwork, and your AI-readiness.
Michael Iantosca (Avalara): Graph-Driven RAG AI Powered by DITA
Can generative AI benefit from structured content? What role play knowledge graphs in this? And what does all of that have to do with DITA? After they discovered the shortcomings of vector-based RAG, there is a buzz in the industry around knowledge graph-driven retrieval-augmented generation (Graph RAG). This session will put the question of whether and how DITA fits into that equation.
Jorge de Antonio, Anna Tsolakou (Amadeus): How LLMs are changing the way we build API specifications
In this session, we’ll share our journey of developing a chatbot powered by Large Language Models (LLMs) capable of customizing API specifications.
Break (10 minutes)
Walter Heck (Helixiora): Smarter Search: How RAG Pipelines Help Navigate Complex Documentation
In this session, we’ll dive into:
• How RAG pipelines work and why they’re a game-changer for documentation search
• Challenges of crawling technical documentation, from handling different formats (PDFs, wikis, APIs) to keeping content up-to-date and makign sense out of not-so-great documentation
• Lessons learned from implementing RAG in Lorelai, including indexing strategies, hallucination mitigation, and user-friendly search experiences
Tammy Lee (Culture Creates): Discoverability Is an Act of Agency: Rethinking Metadata as Cultural Infrastructure
We talk a lot about discoverability but we rarely talk about the infrastructure underneath it. This presentation will share a perspective from outside the traditional tech world, grounded in the cultural sector. I’ll outline how I see metadata as the hidden layer that shapes visibility and meaning online, why it matters, what we need to get right, and what to avoid if we want digital infrastructure that serves the public good.
Gareth Brinn (Gravitee): From Overwhelmed to Optimized: How AI Can Boost Your Documentation Team
This talk dives into a real use case that shows how the use of LLMs like ChaGPT and Claude.ai can be used to generate Release Notes, and then how n8n can be used to automate this process. This use case will demonstrate how through simple methods and strategies, you can maximize your existing Documentation team’s capabilities.
Opening
KEYNOTE- Mehdi Medjaoui (Apidays) - All your docs are belong to us: from UX to DX to AX
This keynote explores the evolution of technical writing in the age of intelligent systems—how writers are not just informing humans, but need to be teaching machines. We’ll dive into the shifting role of documentation as both interface and infrastructure, and reflect on how to design docs that serve users, developers, and algorithms alike—without losing the human voice in the process.
KEYNOTE- Zdenek Nemec (Superface): APIs at the Verge of AI
There are new API consumers on the block: the AI agents. What does this mean for APIs and businesses? Will APIs stay as we know them? What about the API documentation and SDKs? Will there still be engineers manually developing and integrating APIs?
Pooja Vijay Kumar, Aman Talwar (Autodesk): Specs Are Docs Now: Designing OpenAPI for Agentic Interfaces
I’ll share what it means to treat OpenAPI like user-facing documentation—from syntax choices to semantic intent—and how doing so unlocks new affordances for agentic AI.
Jessie Mongeon (Dfinity): Leveraging AI for Efficient Technical Documentation and Routine Maintenance
We’ll explore how AI can be used for managing technical documentation and streamlining routine maintenance tasks. Listeners will learn how to leverage AI to create and automate documentation workflows.
Break (10 minutes)
Stefan Mesquita, Timothy Goodwill (Deutsche Bank): From APIs to AI: How to Build an AI-Ready API Ecosystem
We’ll explore how to design an API ecosystem that supports AI-driven applications while ensuring performance, governance, and cost efficiency. We’ll cover best practices for structuring APIs to optimize data ingestion, enable AI agents to integrate seamlessly, and manage resource usage effectively. Attendees will gain insights into key design considerations that make APIs a strong foundation for AI—whether for training models or deploying intelligent agents.
Manny Silva (Skyflow): Self-Healing Docs: How Agents are Redefining the Docs Pipeline
You'll learn how embedding self-healing capabilities into your docs-as-code or CMS pipelines can dramatically reduce manual maintenance, enhance accuracy, and free technical writers to focus on creative, high-value tasks. We’ll share real-world case studies and practical strategies for implementing documentation systems that continuously verify and repair content, ensuring your API documentation and developer portals stay reliable and resilient to rapid product changes.
Selvaraaju Murugesan (kovai.co): Producing AI-friendly content: Emerging best practices
We will cover some emerging best practices to write GenAI-friendly content. We will also discuss some learnings from interacting with some customers in Chatbot implementation with respect to content restructuring.
Elmer Thomas, Maria Bermudez (Twilio): The Robots are coming for your job, and that's okay.
I’ll share how we decided which agents to build and how we made them more accessible to less-technical Twilions outside of our team. I’ll share some practical ways you can use agents in your own work to simplify your workflows and streamline your authoring process. Once we’ve covered the basics, we can share some ideas we have for taking these agents, and our docs, to the next level.
James Higginbotham (LaunchAny): AI-Assisted API Design and Documentation
AI promises to change how we work. Let's explore how to approach your API design and documentation efforts by leveraging AI assistance to guide us throughout the API delivery lifecycle. We will explore what is required to design and document an API effectively, how to leverage AI to accelerate the process, and keep our APIs prepared for both human and machine consumption.
Break (10 minutes)
Tom Johnson (Google): API quick reference diagrams: boosting comprehension for both human and machine users
As we turn to AI for more advanced documentation authoring, augmenting AI chats with API reference content improves the accuracy of the AI’s responses. Grounding your AI with your API reference basically uploads this intelligence into your AI chat sessions, giving your AI the right knowledge and context to address nearly any documentation scenario. Ultimately, these quick reference diagrams serve a dual role: improving the developer’s understanding of the API while also enhancing the reliability of the AI responses.
David Hou (MongoDB): Rethinking Docs as Code in the age of vibe coding
This session shares some real examples on how we’re experimenting with AI and agentic capabilities at MongoDB, discusses best practices for using AI tools, and imagines alternative methods of interacting with the docs such as through MCP servers.
Kody Jackson (Cloudflare) - Beyond Style Guides: Using AI (and other things) to Automate Documentation Maintenance
At Cloudflare, we move fast. Like, idea-to-ship-in-weeks fast. But speed doesn't excuse sloppy docs. Our users expect the same reliability from our documentation as they do from our products — and that's a high bar.
So how do we maintain quality at scale, with a small team and thousands of pages of documentation? By thinking beyond traditional style guides and leaning into automation, procedure, and smart tooling — including AI.
Michaela Halliwell (HCSS) - Lying to Robots: A Guide to Terrible API Docs (and what to do if you want to fix them)
Michaela Halliwell walks through the real-world checklist you’ll need to make your dev portal AI-friendly. She’ll share lessons learned from launching AI-enhanced tooling like Copilot, explain where LLMs struggle with traditional docs, and help you future-proof your portal for both human and machine consumers.