{"id":5263,"date":"2026-10-08T16:03:53","date_gmt":"2026-10-08T16:03:53","guid":{"rendered":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/2026\/10\/08\/docsy-for-ai-agents-oh-and-people-too\/"},"modified":"2026-10-08T16:03:53","modified_gmt":"2026-10-08T16:03:53","slug":"docsy-for-ai-agents-oh-and-people-too","status":"publish","type":"post","link":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/2026\/10\/08\/docsy-for-ai-agents-oh-and-people-too\/","title":{"rendered":"Docsy for AI Agents, Oh, and People Too"},"content":{"rendered":"
\"\"<\/div>\n

\"\"<\/p>\n

Google\u2019s Docsy is joining the Linux Foundation as AI agents become documentation readers.<\/span><\/p>\n

Prague \u2014 When I grew up in programming, if you didn\u2019t understand something in the code or operating system, you were told to Read The Fine (Ah, yeah, fine) Manual (RTFM). Of course, back then we actually had manuals and documentation. Since then, good documentation has fallen by the wayside. As Jon Corbet, editor of<\/span> LWN<\/span><\/a>, the best deep-dive Linux publication and overseer of Linux kernel documentation, has said, \u201c<\/span>There is not a single person whose job it is to write documentation<\/span><\/a> for the kernel.\u201d In 2026 at <\/span>Linux Plumbers, <\/span><\/a>Corbet said that\u2019s still true today.<\/span><\/p>\n

These days, however, it\u2019s not just disgruntled system administrators and programmers who want good, up-to-date documentation; AI agents want reliable docs as well. No one ever wanted to pay for humans to have good reference materials, but with AI agents, it\u2019s a different story. Without good information, AI is prone to Garbage-In, Garbage-Out (GIGO). That\u2019s where <\/span>Docsy<\/span><\/a>, the open-source documentation theme created by Google\u2019s technical writers, comes in. <\/span><\/p>\n

At <\/span>Open Source Summit Europe<\/span><\/a>, Google announced that Docsy has moved its home base to the Linux Foundation. It also\u2013surprise!\u2013has expanded support for AI agents. <\/span><\/p>\n

The move connects Docsy more closely with an ecosystem that already uses it. Erin McKean, a Google Senior Developer Relations Engineer and a member of the project\u2019s steering committee, said Linux Foundation projects ranging from sandbox-stage efforts to Kubernetes already rely on Docsy. <\/span><\/p>\n

McKean\u2019s argument for the project starts with a more familiar open-source problem: documentation takes work, and maintainers need help producing it. She said better documentation can reduce the burden of answering questions that users could otherwise resolve themselves.<\/span><\/p>\n

Docsy\u2019s developers are adapting documentation publishing to serve two audiences: people reading websites and AI tools retrieving instructions to answer questions or write code. As McKean said in her keynote, \u201cYou can add Markdown right alongside your documentation for tools that prefer that format.\u201d <\/span><\/p>\n

Docsy introduced its first phase of agent support in version 0.15.0. The experimental, opt-in features generate an llms.txt documentation index, Markdown alternatives for home pages, sections, and individual pages, and a \u201cView Markdown\u201d link.<\/span><\/p>\n

Why is this important? It\u2019s because people and AI read documentation differently. A documentation website\u2019s HTML serves you and me with navigation, layout, and presentation. A <\/span>Markdown alternative exposes the underlying explanations<\/span><\/a>, headings, links, and code examples in a simpler text-oriented format, suitable for AI. <\/span><\/p>\n

As Anthropic has explained, modern AI needs documentation like this for <\/span>better context engineering<\/span><\/a>. This is the strategy for \u201ccurating and maintaining the optimal set of tokens (information) during LLM inference, including all the other information that may land there outside of the prompts.\u201d<\/span><\/p>\n

In practice, with Docsy documentation, an agent can consult an index, select pages relevant to its task, and fetch their Markdown versions. Those documents then become context for the language model. The agent can use this information to construct an answer or choose its next action. Anthropic describes this approach as just-in-time retrieval, where an agent dynamically loads information rather than putting everything into its context.<\/span><\/p>\n

Docsy\u2019s release documentation describes the features as helping <\/span>agents \u201cdiscover and use your site content,\u201d <\/span><\/a>rather than promising a particular model outcome.<\/span><\/p>\n

For an AI coding assistant, that could mean retrieving an API\u2019s authentication instructions and endpoint documentation before composing a request. It\u2019s a way to consult published documentation during a task, not a mechanism for retraining the model. <\/span><\/p>\n

Docsy itself is quite simple. It\u2019s a theme for the <\/span>Hugo static site generator<\/span><\/a>. It supplies navigation, site structure, and other components for technical documentation websites. Its code is available under the Apache License 2.0.<\/span><\/p>\n

For McKean, the underlying goal remains helping people use software, even when an AI assistant stands between the reader and the documentation. \u201cBut when we\u2019re making technical documentation, it really doesn\u2019t matter how the information becomes useful to humans, as long as it does,\u201d she said. \u201cIf someone told me that there was evidence that said, you know, opera is the best way to reach your project users, I\u2019d be writing operas.\u201d<\/span><\/p>\n

Read More<\/a><\/p>\n

\u200b<\/p>","protected":false},"excerpt":{"rendered":"

Google\u2019s Docsy is joining the Linux Foundation as AI agents become documentation readers. Prague \u2014 When I grew up in […]<\/p>\n","protected":false},"author":1,"featured_media":5264,"comment_status":"","ping_status":"","sticky":false,"template":"","format":"standard","meta":{"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","ast-disable-related-posts":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"default","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"footnotes":""},"categories":[5],"tags":[],"class_list":["post-5263","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-devops"],"_links":{"self":[{"href":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/wp-json\/wp\/v2\/posts\/5263","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/wp-json\/wp\/v2\/comments?post=5263"}],"version-history":[{"count":0,"href":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/wp-json\/wp\/v2\/posts\/5263\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/wp-json\/wp\/v2\/media\/5264"}],"wp:attachment":[{"href":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/wp-json\/wp\/v2\/media?parent=5263"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/wp-json\/wp\/v2\/categories?post=5263"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/wp-json\/wp\/v2\/tags?post=5263"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}