Developer Docs Platforms arenaDeveloper Docs Platforms
Developer documentation platforms — the authoring, API-reference, and publishing layer for developer-facing docs — judged on MDX authoring and web editing, OpenAPI-driven API references, docs-as-code git workflows with preview deployments and review, versioning and localization, search quality, theming and custom domains, docs analytics, and the deliciously self-referential heart of the arena: the agent-docs layer these vendors now sell — llms.txt generation, .md mirror endpoints, hosted docs MCP servers, embedded AI assistants, and AI agents that maintain the docs. These are the vendors selling the very surfaces this site scores every arena on, so they are judged partly on whether they drink their own champagne (whether mintlify.com/docs itself serves llms.txt, whether GitBook’s own docs expose the MCP server it generates for customers). Docusaurus, Meta’s MIT-licensed static-site generator, anchors the open-source end; Astro Starlight was left for a future static-site-generator arena.
53 user stories · 265 judged cells · updated 2026-09-16 · Evidence as of 2026-09-16
Leaderboard — every product ranked by evidenceLeaderboard
| 1 | free-tier vs Mintlify ↗ | 56/100 | 47/100 | 37/100 | 38/100 | 29/100 | ★ 3.8k▲ 850/yrnpm 190.6k/wk | 13/38 verified · 1 disputed | 28/100 integrity | ||
| 2 | free-tier vs Fern ↗ | 38/100 | 70/100 | 37/100 | 21/100 | 33/100 | npm 179.6k/wk | 12/39 verified · 2 disputed | 18/100 integrity | ||
| 3 | free-tier vs Fern ↗ | 40/100 | 63/100 | 23/100 | 16/100 | 15/100 | 18/34 verified | 42/100 integrity | |||
| 4 | 31/100 | untested | 0/100 | 81/100 | 0/100 | ★ 66.2k▲ 7.2k/yrnpm 1.3M/wk | 10/16 verified | 43/100 integrity | |||
| 5 | free-tier vs Fern ↗ | 44/100 | 33/100 | 23/100 | 16/100 | 13/100 | npm 97.7k/wk | 15/34 verified | 31/100 integrity |
Best by user type — persona-weighted winnersBest by user type
Per persona, the product with the highest persona-weighted coverage over just that persona's stories — not the same ranking as the overall PA Score leaderboard above.
Story matrix — every product × every judged storyStory matrix
Agenticness — how well agents can access and operate the productAgenticness
Agent access
| Story | Persona | |||||
|---|---|---|---|---|---|---|
| Agenticness — how well agents can access and operate the productPoint an agent at llms.txt or agent-oriented docs | ai-native | fullT 9/10 | fullT 8/10 | fullT 9/10 | none 0/10 | fullT 9/10 |
| Agenticness — how well agents can access and operate the productRun the product headlessly / in CI for automation | ai-native | partialT 6/10 | partialX 5/10 | partialT 6/10 | partialT 6/10 | fullT 7/10 |
| Agenticness — how well agents can access and operate the productPlug MCP servers into this product so it can use their tools | ai-native | none 0/10 | none 0/10 | none 0/10 | n/a | n/a |
| Agenticness — how well agents can access and operate the productConnect an agent via an official MCP server | ai-native | fullT 8/10 | fullT 8/10 | fullT 8/10 | n/a | fullT 8/10 |
| Agenticness — how well agents can access and operate the productUse an official CLI | ai-native | fullT 8/10 | fullC 7/10 | partialT 5/10 | fullT 7/10 | fullT 9/10 |
| Agenticness — how well agents can access and operate the productDrive the product through a documented public API | ai-native | partialT 7/10 | fullT 8/10 | fullT 8/10 | partialT 4/10 | partialT 6/10 |
| Agenticness — how well agents can access and operate the productIssue scoped/least-privilege API credentials for an agent | ai-native | disputedD 4/10 | none 0/10 | none 0/10 | n/a | none 0/10 |
| Agenticness — how well agents can access and operate the productBuild against official SDKs | ai-native | none 0/10 | none 0/10 | partialT 3/10 | partialT 5/10 | fullX 8/10 |
| Agenticness — how well agents can access and operate the productSubscribe to events via webhooks | ai-native | none 0/10 | none 0/10 | n/a | n/a | none 0/10 |
Agentic features
| Story | Persona | |||||
|---|---|---|---|---|---|---|
| Agenticness — how well agents can access and operate the productGet AI-generated insights and suggestions from my data inside the product | ai-native | partialC 6/10 | fullC 7/10 | partialC 6/10 | n/a | partialC 6/10 |
| Agenticness — how well agents can access and operate the productSet up automations that run autonomously in the background | ai-native | fullC 8/10 | partialC 5/10 | partialC 4/10 | n/a | partialC 6/10 |
| Agenticness — how well agents can access and operate the productDelegate tasks to a built-in AI assistant inside the product | ai-native | fullC 8/10 | fullC 7/10 | partialC 6/10 | n/a | fullC 7/10 |
| Agenticness — how well agents can access and operate the productOperate the product with natural-language commands | ai-native | fullT 8/10 | fullT 8/10 | partialC 6/10 | n/a | partialC 6/10 |
Api quality
| Story | Persona | |||||
|---|---|---|---|---|---|---|
| Agenticness — how well agents can access and operate the productExplore an interactive API reference with runnable examples | ai-native | fullC 8/10 | fullC 7/10 | fullX 8/10 | none 0/10 | partialC 5/10 |
| Agenticness — how well agents can access and operate the productDownload a machine-readable API spec (OpenAPI or equivalent) | ai-native | partialT 5/10 | none 0/10 | none 0/10 | none 0/10 | fullT 8/10 |
| Agenticness — how well agents can access and operate the productTest against a sandbox environment without touching production data | ai-native | partialC 6/10 | n/a | none 0/10 | n/a | n/a |
| Agenticness — how well agents can access and operate the productRely on versioned APIs with a documented deprecation policy | ai-native | none 0/10 | none 0/10 | none 0/10 | none 0/10 | none 0/10 |
Ai docs — stories about ai docs in this arenaAi docs
Agent access
| Story | Persona | |||||
|---|---|---|---|---|---|---|
| Ai docs — stories about ai docs in this arenaMy published docs site exposes its own MCP server that my users' agents can query for search and page content | ai-native | fullC 8/10 | fullT 7/10 | fullT 8/10 | none 0/10 | fullT 9/10 |
Agent output
| Story | Persona | |||||
|---|---|---|---|---|---|---|
| Ai docs — stories about ai docs in this arenaMy published docs site automatically serves llms.txt (and a full-content variant) so agents can index it | ai-native | fullT 9/10 | fullT 8/10 | fullT 8/10 | none 0/10 | fullT 9/10 |
| Ai docs — stories about ai docs in this arenaEvery published page serves clean markdown at its URL (e.g. appending .md) so agents skip the HTML | ai-native | fullT 8/10 | fullT 7/10 | fullT 7/10 | none 0/10 | disputedD 5/10 |
Assistant
| Story | Persona | |||||
|---|---|---|---|---|---|---|
| Ai docs — stories about ai docs in this arenaAn embedded AI assistant on my docs site answers reader questions with citations into my content | ai-native | fullC 9/10 | fullC 8/10 | partialC 6/10 | none 0/10 | fullC 8/10 |
Writer agent
| Story | Persona | |||||
|---|---|---|---|---|---|---|
| Ai docs — stories about ai docs in this arenaA platform AI agent drafts, updates, and reviews my docs — from a prompt, a PR, or a schedule — and ships its work as change requests | ai-native | fullC 9/10 | fullC 7/10 | partialC 7/10 | n/a | fullC 8/10 |
Analytics insights — stories about analytics insights in this arenaAnalytics insights
Analytics
| Story | Persona | |||||
|---|---|---|---|---|---|---|
| Analytics insights — stories about analytics insights in this arenaMy docs analytics distinguish AI-agent traffic from human traffic so I can see who — or what — is actually reading | ai-native | none 0/10 | none 0/10 | partialC 6/10 | n/a | partialC 6/10 |
| Analytics insights — stories about analytics insights in this arenaI see page views, search terms, and reader feedback so I know which docs work and which fail | devrel-lead | fullC 8/10 | partialX 5/10 | partialC 5/10 | none 0/10 | partialC 5/10 |
Api reference — stories about api reference in this arenaApi reference
Playground
| Story | Persona | |||||
|---|---|---|---|---|---|---|
| Api reference — stories about api reference in this arenaReaders can try real API calls from an interactive playground embedded in the reference docs | developer | fullC 8/10 | fullC 7/10 | fullX 8/10 | none 0/10 | none 0/10 |
Spec driven
| Story | Persona | |||||
|---|---|---|---|---|---|---|
| Api reference — stories about api reference in this arenaMy API reference pages are generated from an OpenAPI spec and stay in sync when the spec changes | developer | fullC 8/10 | partialC 6/10 | fullX 8/10 | none 0/10 | fullC 7/10 |
Authoring editing — stories about authoring editing in this arenaAuthoring editing
Authoring
| Story | Persona | |||||
|---|---|---|---|---|---|---|
| Authoring editing — stories about authoring editing in this arenaI author pages in Markdown/MDX with rich components — tabs, callouts, code groups, steps — without writing custom HTML | technical-writer | none 0/10 | partialX 7/10 | partialC 5/10 | partialX 6/10 | partialC 6/10 |
| Authoring editing — stories about authoring editing in this arenaNon-technical teammates can edit docs in a visual web editor without touching git, and their changes flow into the same source of truth | technical-writer | fullC 8/10 | fullX 8/10 | fullC 8/10 | none 0/10 | fullC 8/10 |
Content reuse
| Story | Persona | |||||
|---|---|---|---|---|---|---|
| Authoring editing — stories about authoring editing in this arenaReusable snippets and variables keep repeated content in sync across pages | technical-writer | none 0/10 | fullC 8/10 | fullC 8/10 | partialC 6/10 | none 0/10 |
Automation depth — how much of the product can run unattendedAutomation depth
| Story | Persona | |||||
|---|---|---|---|---|---|---|
| Automation depth — how much of the product can run unattendedPerform bulk operations across many items at once | ai-native | partialC 5/10 | partialT 5/10 | partialT 4/10 | none 0/10 | partialC 4/10 |
| Automation depth — how much of the product can run unattendedDefine rules that trigger actions automatically on events | ai-native | partialC 6/10 | none 0/10 | none 0/10 | n/a | partialC 5/10 |
| Automation depth — how much of the product can run unattendedSchedule recurring jobs or workflows | ai-native | partialC 5/10 | n/a | n/a | n/a | partialC 5/10 |
| Automation depth — how much of the product can run unattendedVersion, review, and roll back my automations | ai-native | partialC 6/10 | partialC 5/10 | partialC 5/10 | n/a | partialC 5/10 |
Collaboration review — stories about collaboration review in this arenaCollaboration review
Review
| Story | Persona | |||||
|---|---|---|---|---|---|---|
| Collaboration review — stories about collaboration review in this arenaTeammates propose changes that go through review — comments, approvals, and a merge step — before they publish | technical-writer | fullC 8/10 | fullC 8/10 | partialC 6/10 | n/a | partialC 4/10 |
Customization — bending the product to your needs — settings, theming, extension pointsCustomization
Theming
| Story | Persona | |||||
|---|---|---|---|---|---|---|
| Customization — bending the product to your needs — settings, theming, extension pointsI customize themes, fonts, and layout — down to custom CSS/JS or my own components — so the docs match my brand | devrel-lead | partialC 5/10 | partialX 4/10 | fullX 8/10 | fullX 9/10 | none 0/10 |
Docs as code — stories about docs as code in this arenaDocs as code
Git workflow
| Story | Persona | |||||
|---|---|---|---|---|---|---|
| Docs as code — stories about docs as code in this arenaMy docs live in my own git repository — branches, pull requests, and merges drive what gets published | developer | fullC 8/10 | fullX 8/10 | fullC 8/10 | fullX 8/10 | partialC 6/10 |
| Docs as code — stories about docs as code in this arenaEvery docs pull request gets a shareable preview deployment before it merges | developer | fullC 8/10 | fullC 7/10 | none 0/10 | n/a | partialC 4/10 |
Quality gates
| Story | Persona | |||||
|---|---|---|---|---|---|---|
| Docs as code — stories about docs as code in this arenaCI validation catches broken links and invalid configuration before the site publishes | developer | partialC 4/10 | none 0/10 | none 0/10 | none 0/10 | none 0/10 |
Openness — open source, data portability, and self-hosting storiesOpenness
| Story | Persona | |||||
|---|---|---|---|---|---|---|
| Openness — open source, data portability, and self-hosting storiesDo everything through the API that I can do in the UI | ai-native | partialT 6/10 | partialT 6/10 | partialT 6/10 | n/a | partialT 5/10 |
| Openness — open source, data portability, and self-hosting storiesExport all of my data in open formats and leave | ai-native | partialX 5/10 | partialX 5/10 | partialC 5/10 | fullX 8/10 | partialX 5/10 |
| Openness — open source, data portability, and self-hosting storiesRead the product's source under an open license | ai-native | none 0/10 | none 0/10 | none 0/10 | fullX 7/10 | fullX 7/10 |
| Openness — open source, data portability, and self-hosting storiesSelf-host the core product | ai-native | disputedD 5/10 | none 0/10 | none 0/10 | fullX 9/10 | partialX 5/10 |
Privacy posture — data-handling and privacy storiesPrivacy posture
| Story | Persona | |||||
|---|---|---|---|---|---|---|
| Privacy posture — data-handling and privacy storiesChoose where my data is stored (region/residency) | ai-native | none 0/10 | none 0/10 | none 0/10 | n/a | none 0/10 |
| Privacy posture — data-handling and privacy storiesPrevent my data from being used to train AI models | ai-native | none 0/10 | none 0/10 | none 0/10 | n/a | n/a |
| Privacy posture — data-handling and privacy storiesControl data retention and deletion | ai-native | none 0/10 | none 0/10 | none 0/10 | n/a | none 0/10 |
| Privacy posture — data-handling and privacy storiesOpt out of telemetry and usage tracking | ai-native | none 0/10 | none 0/10 | none 0/10 | none 0/10 | none 0/10 |
Publishing hosting — stories about publishing hosting in this arenaPublishing hosting
Access control
| Story | Persona | |||||
|---|---|---|---|---|---|---|
| Publishing hosting — stories about publishing hosting in this arenaI gate some or all docs behind authentication — password, JWT, or SSO — for customers-only content | devrel-lead | partialC 5/10 | partialC 6/10 | none 0/10 | none 0/10 | fullC 8/10 |
Domains
| Story | Persona | |||||
|---|---|---|---|---|---|---|
| Publishing hosting — stories about publishing hosting in this arenaI serve docs on my own custom domain or as a /docs subpath of my main site | devrel-lead | fullC 9/10 | fullC 8/10 | fullC 8/10 | partialC 5/10 | fullC 8/10 |
Portability
| Story | Persona | |||||
|---|---|---|---|---|---|---|
| Publishing hosting — stories about publishing hosting in this arenaExport my entire docs site as a static bundle and host it anywhere, so my content is never locked in | developer | partialX 4/10 | none 0/10 | partialC 3/10 | fullC 9/10 | partialC 3/10 |
Search discovery — stories about search discovery in this arenaSearch discovery
Search
| Story | Persona | |||||
|---|---|---|---|---|---|---|
| Search discovery — stories about search discovery in this arenaReaders get fast, typo-tolerant, relevance-ranked search over the whole docs site out of the box | developer | partialC 6/10 | partialX 6/10 | none 0/10 | partialC 5/10 | partialC 4/10 |
Versioning localization — stories about versioning localization in this arenaVersioning localization
Localization
| Story | Persona | |||||
|---|---|---|---|---|---|---|
| Versioning localization — stories about versioning localization in this arenaI publish my docs in multiple languages with translated navigation and content | technical-writer | none 0/10 | partialX 6/10 | none 0/10 | fullC 9/10 | none 0/10 |
Versioning
| Story | Persona | |||||
|---|---|---|---|---|---|---|
| Versioning localization — stories about versioning localization in this arenaI publish versioned documentation per product or API version, and readers switch versions from the site | developer | partialC 3/10 | partialC 6/10 | partialC 5/10 | fullC 9/10 | fullC 8/10 |
Adjacent arenas — categories often shopped togetherAdjacent arenas
Shopping this category often means shopping these too.
API platforms arenaAPI platforms
5 products · leader: Postman
Search Infrastructure arenaSearch Infrastructure
5 products · leader: Algolia
MCP Infrastructure & Registries arenaMCP Infrastructure & Registries
6 products · leader: Composio
Desktop OS arenaDesktop OS
5 products · leader: Omarchy
shares: Customization