For AI agents: a documentation index is available at /llms.txt — markdown versions of all pages are available by appending index.md to any URL path.

Microblog

Ok, lunch thought and I'm curious for your input, Technical Writers - no wrong…

AIAgentsDocumentation

Ok, lunch thought and I'm curious for your input, Technical Writers - no wrong answers here.

So far, as I've been digging into agent-friendly docs, I've been focusing mostly on static analysis - what can we measure - to derive some early findings and focus initial exploration.

But at lunch, I started thinking - what does "developer documentation" look like in 2 years? 3 years? 5 years?

Where do we draw the distinction in writing for developers - i.e. the agents - and writing for the humans running the agents? Are these distinct personas that require their own documentation sets? What belongs in each? And how do we serve the industries where regulation or other limits constrain their AI usage?

What do you think? Let's brainstorm!

All microblog posts · RSS