Programming and Software Development

Google’s Docsy Project Moves to the Linux Foundation to Prepare Documentation for AI Agents

The open-source Docsy project, used in the documentation for projects such as Kubernetes and OpenTelemetry, is moving to the Linux Foundation while developing features that make documentation easier for AI agents to read. The project is working on a way to measure how suitable documentation is for automated discovery, navigation, and consumption.

2026-10-07
3 min read
246 views
certi.news Editorial Team
Google’s Docsy Project Moves to the Linux Foundation to Prepare Documentation for AI Agents

The open-source Docsy project, created by Google to build documentation sites using the Hugo static site generator, is moving to the Linux Foundation at a time when technical documentation has become a direct source for AI agents, not just developers.

Erin McKean, a developer relations engineer at Google and a member of Docsy’s steering committee, announced the move during a talk she gave Wednesday at the Linux Foundation’s Open Source Summit Europe in Prague. The move is partly based on Docsy’s adoption across the foundation’s associated project ecosystem; by the end of 2024, approximately 2,200 projects were using it, including projects in the Cloud Native Computing Foundation such as Kubernetes, OpenTelemetry, gRPC, and Jaeger.

A documentation project turning toward an automated audience

Docsy was first announced in 2019. It is an open-source template designed for technical documentation and can be used with open or private projects. However, recent changes focus on how AI tools access content and on the form of instructions these tools need to carry out project-related tasks.

Since the 0.15.0 release in May, Docsy has been able to generate a Markdown version of every page alongside the usual HTML version. It can also generate an llms.txt file that provides an index of the site’s content. Both features are optional and experimental.

In version 0.16.0, released in July, an upgrade guide was added that was formatted so an automated assistant could follow it, including prerequisites, steps, and verification procedures. Version 0.17.0, released in August, added a hidden directive at the top of every page for users who enable llms.txt, directing visiting agents to the site index. This feature also remains experimental.

What changes in practice?

Docsy shifts part of the task of improving documentation from merely formatting pages for human reading to organizing content so models and agents can find, understand, and follow it. For projects that rely on contributors or external users, this could mean directing AI tools to a clearer version of the instructions instead of leaving them to infer the instructions from public HTML pages.

McKean says better documentation can reduce routine questions reaching maintainers because answers become available to users before a maintainer intervenes. This is a potential operational benefit for projects, but it does not in itself mean that agents will understand the content correctly or that the documentation will automatically become accurate.

Next step: measuring readability for agents

The Docsy team is working on what it calls AF documentation scores, meaning scores for how suitable documentation is for agents. The goal is to give maintainers a metric for evaluating AI tools’ ability to discover, navigate, and consume documentation, rather than relying solely on guesswork.

The source does not yet explain the form of this metric, its final criteria, or when it will launch. Markdown and llms.txt features and the directives associated with them are also optional and experimental, so their practical impact remains dependent on projects adopting them and on the quality of the original content they produce.

News source
The New Stack - Software Development
Open original source ↗
c
Author

certi.news Editorial Team

What you need to know

The open-source Docsy project is moving from Google to the Linux Foundation, while developing features that make documentation easier for AI agents to access and understand. The project has experimentally added Markdown page generation and an llms.txt file, and is developing a metric to evaluate how discoverable, navigable, and machine-consumable documentation is.

  • Docsy is an open-source template for building documentation sites with the Hugo static site generator, used by approximately 2,200 projects as of the end of 2024.
  • The project moved to the Linux Foundation because of its adoption across the foundation’s project ecosystem, including Kubernetes, OpenTelemetry, gRPC, and Jaeger.
  • Since version 0.15.0, Docsy can generate a Markdown version of pages and an llms.txt file that provides an index of site content, but both features are optional and experimental.
  • Version 0.16.0 added an upgrade guide that an automated assistant can follow, while version 0.17.0 added a directive that sends agents to the site index when llms.txt is enabled.
  • The Docsy team is working on AF documentation scores to measure AI agents’ ability to discover, navigate, and consume documentation.
  • Using these features does not guarantee that agents will understand documentation correctly, as the practical impact depends on project adoption and the quality of the original content.

FAQ

What is the Docsy project?

It is an open-source template created by Google for building technical documentation sites with the Hugo static site generator.

What is the purpose of the llms.txt file in Docsy?

It provides an index of documentation site content and helps direct AI agents to that content, while remaining an optional and experimental feature.

What are AF documentation scores?

They are a metric that the Docsy team is developing to evaluate how well AI tools can discover, navigate, and consume documentation.

Are Docsy’s new features stable?

No. The Markdown and llms.txt features, along with the related directives, have been described as optional and experimental.

In the same category

You may also like

View all news