Why documentation won't go fully headless 0 ▲ This is important 15 hours ago · 9 min read1820 words · Tech · hide I was at an event for Write the Docs a few weeks ago and someone asked me if I thought we would see fully headless documentation at some point. I instinctively and reactively said “no” immediately, but I’ve been thinking about that question and my answer since then. Headless documentation doesn’t refer to content produced by a headless horseman, but rather content that is not visible on a website by humans and instead available purely through programmatic or agent-accessible means. Currently, agents are accessing documentation through the web, crawling websites. If people stop visiting documentation sites, what other ways might we use to deliver documentation content to them where they are? Is there a potential future where documentation is published “headlessly”? Agents are the primary audience of software documentation According to several documentation platforms (with ample aggregate server traffic data), agents outnumber human readers of documentation: GitBook published Research:… Commenting on Bubbles has been removed. Why? If you want to talk about this post, write to the author, use the comments on their blog if it has them, or reply with a "RE:" post on your own blog. Suggestions? feedback@bubbles.town