La documentación técnica está experimentando un cambio significativo: cada vez son más los agentes de inteligencia artificial (IA) que la leen y procesan, lo que exige repensar la forma en que se publica y estructura esta información. En respuesta a esta evolución, Docsy, el proyecto de documentación originado en Google y adoptado masivamente por importantes iniciativas del ecosistema cloud native, ha anunciado su traslado a la Fundación Linux, donde continuará su desarrollo incorporando funcionalidades específicas para facilitar su consumo por sistemas automáticos.
La noticia fue comunicada por Erin McKean, ingeniera senior de relaciones con desarrolladores en Google y miembro del comité directivo de Docsy, durante su ponencia en el Open Source Summit Europe celebrado en Praga. La decisión responde a que muchos de los proyectos que ya utilizan Docsy forman parte de las comunidades que gestiona la Fundación Linux, como Kubernetes, OpenTelemetry, gRPC o Jaeger, lo que facilita una colaboración más estrecha y un desarrollo orientado a los usuarios reales.
Creado en 2019 por Google, Docsy es un tema de código abierto para el generador de sitios estáticos Hugo, especialmente diseñado para crear documentación técnica. Aunque sirve para proyectos tanto abiertos como propietarios, goza de una enorme popularidad en el ámbito del software libre. A finales de 2024, más de 2.200 proyectos se valían de Docsy, consolidándolo como un estándar en la documentación de tecnologías cloud native. 
La IA como nuevo consumidor de la documentación técnica
En su intervención, McKean puso especial énfasis en el papel creciente de la inteligencia artificial como lector y usuario de la documentación técnica. Reconoció que algunos documentalistas tradicionales pueden mostrar cierta reticencia ante esta tendencia, puesto que la llegada de la IA parece haber sido el impulso para destinar más recursos a mejorar la documentación. Sin embargo, la prioridad debe ser que la información llegue y sea útil para los desarrolladores, independientemente del canal o interlocutor.
“Cuando creamos documentación técnica, realmente no importa cómo esa información llegue a ser útil para los humanos, lo importante es que lo sea”.
Para facilitar la lectura por herramientas de IA, Docsy ya ha comenzado a evolucionar. Desde su versión 0.15.0, lanzada en mayo de 2026, es posible generar junto al HTML habitual una copia en Markdown de cada página, así como un archivo llms.txt que actúa como índice para estas tecnologías. Ambas funcionalidades son optativas y experimentales, pero marcan el camino hacia un acceso más directo y efectivo para los agentes automatizados.
Así, explica McKean, se puede redirigir a los grandes modelos de lenguaje y agentes hacia los textos que describen cómo utilizar un proyecto, mejorando su capacidad para entender y ayudar a los usuarios finales.
Las versiones posteriores de Docsy han seguido innovando: en la 0.16.0, publicada en julio, se introdujo una guía de actualización diseñada para poder ser seguida también por asistentes IA, que incorporaba condiciones, pasos y comprobaciones como instrucciones explícitas. En agosto, con la versión 0.17.0, se añadió una directiva oculta en la parte superior de cada página para señalar a los agentes la localización del archivo llms.txt, mejorando la navegación automatizada del contenido. Esta característica también continúa en fase experimental.
Hacia una puntuación que mida la facilidad para agentes
Entre los próximos desarrollos está la implementación de puntuaciones “AF” (agent-friendly o amigables para agentes), que permitirán a los responsables de proyectos evaluar qué tan eficiente es su documentación para ser localizada, navegada y consumida por IA. Según McKean, con estas métricas objetivas, los equipos podrán dejar de conjeturar y podrán mejorar sus documentos con un criterio claro y medible.
Además de facilitar la interacción con máquinas, esta mejora también reduce la carga de trabajo de los mantenedores humanos. Una documentación clara y accesible evita que estas personas tengan que responder una gran cantidad de preguntas rutinarias o repetitivas, liberándolas para concentrarse en tareas más complejas.
“Cuando tienes buena documentación, disminuye la cantidad de consultas que pueden ser fácilmente respondidas con ella, aliviando así a los mantenedores”, concluye McKean.
