Half your readers are now bots. 3 urgent fixes for your docs
Half of documentation traffic is now AI agents. Here are three concrete changes I'm making to keep my docs useful for both human and machine readers.
Ivan Walsh Blog
Ivan Walsh Blog
Latest posts
MCP server documentation — the five things most teams get wrong
Most MCP servers are underdocumented. After working with AI systems in regulated financial environments, I keep seeing the same five mistakes. Here is what they are and how to fix them.
What Is an AI Model Card? A Plain-Language Guide for Technical Writers
AI model cards are the documentation layer that makes artificial intelligence systems transparent, accountable, and auditable. Here is what they are, why they matter, and how to get started writing one.
LLM Knowledge Bases
When Andrej Karpathy shared his approach to LLM-powered personal knowledge bases, something clicked. What struck me was the specific inversion he described - the LLM doesn't just query your knowledge, it authors and maintains it.
What is an MCP server and why does it need documentation?
Most teams shipping AI products are not documenting the MCP layer that connects the model to everything else. Here is why that matters and what to do about it.
Why I Added an llms.txt to My Documentation Site — and You Should Too
A technical writer's guide to the llms.txt standard — what it is, why it matters for AI accuracy, and how to auto-generate it on every build.
The Human Task
Why AI isn't coming for your job but the *tasks* that make up your job.
How to use Truth Tables for Technical Documentation
How to use Truth Tables for Technical Documentation Part 1
Getting Started with Agile for Technical Writers
How to get started with Agile for Technical Writers
Using Antora to Manage Complex Technical Documentation Websites
Learn how to use Antora to Manage Complex Technical Documentation Websites. Includes product comparison with other static site generators