How Docusaurus’s scores are calculated
The full audit trail, recomputed from the verdict data at build time through the same code that produced the leaderboard: verdict × quality × story weight per cell, cells sum to dimension scores, dimensions blend into the PA Score. Every number on the product page is reproducible from this page alone; for why the formula looks like this, see the methodology.
verdict factors: full ×1.0 · partial ×0.6 · disputed ×0.3 · none ×0.0 · n/a excluded from both sides · cell points = weight × quality × factor · cell max = weight × 10
PA Score30/100
Agent-ready 31.3 × 0.30 = 9.39
API quality 0.0 × 0.20 = 0.00
Openness 81.3 × 0.20 = 16.26
Built-in AI n/a — excluded, its ×0.15 weight renormalized away
Automation 0.0 × 0.15 = 0.00
(9.39 + 0.00 + 16.26 + 0.00) ÷ (0.30 + 0.20 + 0.20 + 0.15) = 25.65 ÷ 0.85 = 30.2 — weights renormalized over the scored components
Scores are stored to 1 decimal; the product page’s pills round to whole numbers for display. Each dimension below shows the stories, verdicts, and cited evidence behind its number.
Agent-ready31.3/100×0.30 of the PA blend
Outside-in: can YOUR agent reach and drive this product — API, MCP, CLI, headless runs, agent docs.
Point an agent at llms.txt or agent-oriented docsweight 2
2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max
Run the product headlessly / in CI for automationweight 2
2 (weight) × 6 (quality) × 0.6 (partial) = 7.2 of 20 max
- [claimed-docs] https://docusaurus.io/docs/deployment“To build the static files of your website for production, run: npm run build”
- [claimed-docs] https://docusaurus.io/docs/deployment“Once it finishes, the static files will be generated within the `build` directory.”
- [claimed-docs] https://docusaurus.io/docs/deployment“Docusaurus provides a [`docusaurus serve`](/docs/cli#docusaurus-serve-sitedir) command for that”
- [claimed-docs] https://docusaurus.io/docs/deployment“You can deploy your site to static site hosting services such as [Vercel](https://vercel.com/), [GitHub Pages](https://pages.github.com/), [Netlify](https://www.netlify.com/), [Render](https://render.com/docs/static-sites), and [Surge](https://surge.sh/help/getting-started-with-surge).”
- [probe] https://docusaurus.io/docs/cli“official CLI documented at https://docusaurus.io/docs/cli”
- [community] https://hn.algolia.com/api/v1/items/41387922“I haven't used Starlight, but Docusaurus is very slow. The last time I used it, its performance on a large documentation site was terrible, even causing the GitHub Actions Runner to time out. In other words, a single build took over 30 minutes.”
- [community] https://hn.algolia.com/api/v1/items/41387922“I tried migrating our markdown docs-as-code to use Docusaurus, we have somewhere around several hundred pages, and the build times seemed very long (5-10 minutes) compared to a simple bespoke python-based static site generator.”
Plug MCP servers into this product so it can use their toolsweight 3
n/a — not applicable to this product: excluded from numerator and denominator
no evidence cited — the verdict rests on absence of evidence, re-checked on refresh
Connect an agent via an official MCP serverweight 3
n/a — not applicable to this product: excluded from numerator and denominator
no evidence cited — the verdict rests on absence of evidence, re-checked on refresh
Use an official CLIweight 2
2 (weight) × 7 (quality) × 1.0 (full) = 14.0 of 20 max
- [claimed-docs] https://docusaurus.io/docs/installation“npx create-docusaurus@latest my-website classic”
- [claimed-docs] https://docusaurus.io/docs/cli“Builds and serves a preview of your site locally with Webpack Dev Server.”
- [claimed-docs] https://docusaurus.io/docs/versioning“You can use the versioning CLI to create a new documentation version based on the latest content in the docs directory.”
- [claimed-docs] https://docusaurus.io/docs/deployment“Docusaurus provides a [`docusaurus serve`](/docs/cli#docusaurus-serve-sitedir) command for that”
- [probe] https://docusaurus.io/docs/cli“official CLI documented at https://docusaurus.io/docs/cli”
Drive the product through a documented public APIweight 3
3 (weight) × 4 (quality) × 0.6 (partial) = 7.2 of 30 max
- [claimed-docs] https://docusaurus.io/docs/cli“Builds and serves a preview of your site locally with Webpack Dev Server.”
- [claimed-docs] https://docusaurus.io/docs/cli“Builds and serves a preview of your site locally with [Webpack Dev Server]”
- [claimed-docs] https://docusaurus.io/docs/deployment“Docusaurus provides a [`docusaurus serve`](/docs/cli#docusaurus-serve-sitedir) command for that”
- [claimed-docs] https://docusaurus.io/docs/using-plugins“All features are delegated to individual plugins: the docs feature provided by the docs plugin; the blog feature provided by the blog plugin; or individual pages provided by the pages plugin.”
- [claimed-docs] https://docusaurus.io/docs/using-plugins“A plugin is usually an npm package, so you install them like other npm packages using npm.”
- [probe] https://docusaurus.io/docs/cli“official CLI documented at https://docusaurus.io/docs/cli”
- [probe] https://docusaurus.io/llms.txt“PROBE llms.txt: HTTP 404 at https://docusaurus.io/llms.txt”
- [probe] https://docusaurus.io/docs.md“PROBE docs-md: HTTP 404 at https://docusaurus.io/docs.md”
- [probe] https://docusaurus.io/openapi.json“PROBE openapi: all candidate paths 404 (https://docusaurus.io/openapi.json, https://docusaurus.io/swagger.json, https://docusaurus.io/api/openapi.json, https://docusaurus.io/.well-known/openapi.json)”
Issue scoped/least-privilege API credentials for an agentweight 2
n/a — not applicable to this product: excluded from numerator and denominator
no evidence cited — the verdict rests on absence of evidence, re-checked on refresh
Build against official SDKsweight 2
2 (weight) × 5 (quality) × 0.6 (partial) = 6.0 of 20 max
- [claimed-docs] https://docusaurus.io“Extend and customize your project's layout by writing React components. Leverage the pluggable architecture, and design your own site while reusing the same data created by Docusaurus plugins.”
- [claimed-docs] https://docusaurus.io/docs/using-plugins“All features are delegated to individual plugins: the docs feature provided by the docs plugin; the blog feature provided by the blog plugin; or individual pages provided by the pages plugin.”
- [claimed-docs] https://docusaurus.io/docs/swizzling“swizzling permits to swap a theme component with your own implementation”
- [claimed-docs] https://docusaurus.io/docs/using-plugins“A plugin is usually an npm package, so you install them like other npm packages using npm.”
- [probe] https://docusaurus.io/docs/cli“official CLI documented at https://docusaurus.io/docs/cli”
- [probe] https://docusaurus.io/llms.txt“PROBE llms.txt: HTTP 404 at https://docusaurus.io/llms.txt”
- [probe] https://docusaurus.io/docs.md“PROBE docs-md: HTTP 404 at https://docusaurus.io/docs.md”
- [probe] https://docusaurus.io/openapi.json“PROBE openapi: all candidate paths 404 (https://docusaurus.io/openapi.json, https://docusaurus.io/swagger.json, https://docusaurus.io/api/openapi.json, https://docusaurus.io/.well-known/openapi.json)”
Subscribe to events via webhooksweight 2
n/a — not applicable to this product: excluded from numerator and denominator
no evidence cited — the verdict rests on absence of evidence, re-checked on refresh
Agent-ready = 34.4 ÷ 110 × 100 = 31.3
API quality0.0/100×0.20 of the PA blend
The programmable surface once an agent is there — machine-readable spec, interactive docs, sandbox, versioning discipline.
Explore an interactive API reference with runnable examplesweight 2
2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max
- [claimed-docs] https://docusaurus.io/docs/markdown-features/react“Docusaurus has built-in support for MDX, which allows you to write JSX within your Markdown files and render them as React components.”
- [claimed-docs] https://docusaurus.io/docs/markdown-features/react“You can also import your own components defined in other files or third-party components installed via npm.”
- [probe] https://docusaurus.io/openapi.json“PROBE openapi: all candidate paths 404 (https://docusaurus.io/openapi.json, https://docusaurus.io/swagger.json, https://docusaurus.io/api/openapi.json, https://docusaurus.io/.well-known/openapi.json)”
Download a machine-readable API spec (OpenAPI or equivalent)weight 2
2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max
- [probe] https://docusaurus.io/openapi.json“PROBE openapi: all candidate paths 404 (https://docusaurus.io/openapi.json, https://docusaurus.io/swagger.json, https://docusaurus.io/api/openapi.json, https://docusaurus.io/.well-known/openapi.json)”
- [probe] https://docusaurus.io/llms.txt“PROBE llms.txt: HTTP 404 at https://docusaurus.io/llms.txt”
- [probe] https://docusaurus.io/docs.md“PROBE docs-md: HTTP 404 at https://docusaurus.io/docs.md”
Test against a sandbox environment without touching production dataweight 1
n/a — not applicable to this product: excluded from numerator and denominator
no evidence cited — the verdict rests on absence of evidence, re-checked on refresh
Rely on versioned APIs with a documented deprecation policyweight 2
2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max
- [claimed-docs] https://docusaurus.io/docs“Docusaurus v2+ has been a total rewrite from Docusaurus v1, taking advantage of a completely modernized toolchain.”
- [claimed-docs] https://docusaurus.io/docs/versioning“You can use the versioning CLI to create a new documentation version based on the latest content in the docs directory.”
- [claimed-docs] https://docusaurus.io“Support users on all versions of your project. Document versioning helps you keep documentation in sync with project releases.”
API quality = 0.0 ÷ 60 × 100 = 0.0
Openness81.3/100×0.20 of the PA blend
Can you leave, inspect, or self-host — data export, open source, portability.
Do everything through the API that I can do in the UIweight 2
n/a — not applicable to this product: excluded from numerator and denominator
- [claimed-docs] https://docusaurus.io/docs/installation“npx create-docusaurus@latest my-website classic”
- [claimed-docs] https://docusaurus.io/docs/cli“Builds and serves a preview of your site locally with Webpack Dev Server.”
- [claimed-docs] https://docusaurus.io“Extend and customize your project's layout by writing React components. Leverage the pluggable architecture, and design your own site while reusing the same data created by Docusaurus plugins.”
- [probe] https://docusaurus.io/docs/cli“official CLI documented at https://docusaurus.io/docs/cli”
Export all of my data in open formats and leaveweight 3
3 (weight) × 8 (quality) × 1.0 (full) = 24.0 of 30 max
- [claimed-docs] https://docusaurus.io“Simply write docs and blog posts with MDX, and Docusaurus builds them into static HTML files ready to be served.”
- [claimed-docs] https://docusaurus.io“Simply write docs and blog posts with MDX, and Docusaurus builds them into static HTML files ready to be served. You can even embed React components in your Markdown thanks to MDX.”
- [claimed-docs] https://docusaurus.io/docs/deployment“To build the static files of your website for production, run: npm run build”
- [claimed-docs] https://docusaurus.io/docs/deployment“Once it finishes, the static files will be generated within the `build` directory.”
- [claimed-docs] https://docusaurus.io“Localization comes out-of-the-box. Use git, Crowdin, or any other translation manager to translate your docs and deploy them individually.”
- [claimed-docs] https://docusaurus.io“Use git, Crowdin, or any other translation manager to translate your docs and deploy them individually.”
- [community] https://hn.algolia.com/api/v1/items/41387922“It's probably also a good thing that Facebook dogfoods Docusaurus in some places, while keeping it MIT licensed so the community can fork it if Facebook ever decides to stop maintaining it.”
- [community] https://hn.algolia.com/api/v1/items/41387922“For writing technical styled documentation, I've found fumadocs to be amazing... We just moved to it from Docusaurus and couldn't be happier.”
Read the product's source under an open licenseweight 2
2 (weight) × 7 (quality) × 1.0 (full) = 14.0 of 20 max
- [community] https://hn.algolia.com/api/v1/items/41387922“It's probably also a good thing that Facebook dogfoods Docusaurus in some places, while keeping it MIT licensed so the community can fork it if Facebook ever decides to stop maintaining it.”
- [community] https://hn.algolia.com/api/v1/items/32303052“So happy to see Docusaurus hit the big 2.0! I use it to power my blog and it's a tremendous tool. The DX is fantastic and it's open source! I've been able to contribute to it myself.”
Self-host the core productweight 3
3 (weight) × 9 (quality) × 1.0 (full) = 27.0 of 30 max
- [claimed-docs] https://docusaurus.io/docs/deployment“To build the static files of your website for production, run: npm run build”
- [claimed-docs] https://docusaurus.io/docs/deployment“Once it finishes, the static files will be generated within the `build` directory.”
- [claimed-docs] https://docusaurus.io/docs/deployment“You can deploy your site to static site hosting services such as [Vercel](https://vercel.com/), [GitHub Pages](https://pages.github.com/), [Netlify](https://www.netlify.com/), [Render](https://render.com/docs/static-sites), and [Surge](https://surge.sh/help/getting-started-with-surge).”
- [claimed-docs] https://docusaurus.io/docs/deployment“Docusaurus provides a [`docusaurus serve`](/docs/cli#docusaurus-serve-sitedir) command for that”
- [community] https://hn.algolia.com/api/v1/items/41387922“It's probably also a good thing that Facebook dogfoods Docusaurus in some places, while keeping it MIT licensed so the community can fork it if Facebook ever decides to stop maintaining it.”
- [claimed-docs] https://docusaurus.io“Simply write docs and blog posts with MDX, and Docusaurus builds them into static HTML files ready to be served.”
Openness = 65.0 ÷ 80 × 100 = 81.3
Built-in AIn/a×0.15 of the PA blend
Inside-out: how agentic the product itself is for its users — built-in assistants, autonomous features.
Get AI-generated insights and suggestions from my data inside the productweight 2
n/a — not applicable to this product: excluded from numerator and denominator
no evidence cited — the verdict rests on absence of evidence, re-checked on refresh
Set up automations that run autonomously in the backgroundweight 2
n/a — not applicable to this product: excluded from numerator and denominator
no evidence cited — the verdict rests on absence of evidence, re-checked on refresh
Delegate tasks to a built-in AI assistant inside the productweight 3
n/a — not applicable to this product: excluded from numerator and denominator
no evidence cited — the verdict rests on absence of evidence, re-checked on refresh
Operate the product with natural-language commandsweight 2
n/a — not applicable to this product: excluded from numerator and denominator
no evidence cited — the verdict rests on absence of evidence, re-checked on refresh
every cell n/a — unscored (not zero), excluded from the blend
Automation0.0/100×0.15 of the PA blend
Depth of automation primitives — rules, scheduling, bulk operations, webhooks.
Perform bulk operations across many items at onceweight 2
2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max
- [claimed-docs] https://docusaurus.io/docs/cli“Builds and serves a preview of your site locally with Webpack Dev Server.”
- [claimed-docs] https://docusaurus.io/docs/versioning“You can use the versioning CLI to create a new documentation version based on the latest content in the docs directory.”
- [probe] https://docusaurus.io/llms.txt“PROBE llms.txt: HTTP 404 at https://docusaurus.io/llms.txt”
- [probe] https://docusaurus.io/docs.md“PROBE docs-md: HTTP 404 at https://docusaurus.io/docs.md”
- [probe] https://docusaurus.io/openapi.json“PROBE openapi: all candidate paths 404 (https://docusaurus.io/openapi.json, https://docusaurus.io/swagger.json, https://docusaurus.io/api/openapi.json, https://docusaurus.io/.well-known/openapi.json)”
Define rules that trigger actions automatically on eventsweight 3
n/a — not applicable to this product: excluded from numerator and denominator
no evidence cited — the verdict rests on absence of evidence, re-checked on refresh
Schedule recurring jobs or workflowsweight 2
n/a — not applicable to this product: excluded from numerator and denominator
no evidence cited — the verdict rests on absence of evidence, re-checked on refresh
Version, review, and roll back my automationsweight 1
n/a — not applicable to this product: excluded from numerator and denominator
no evidence cited — the verdict rests on absence of evidence, re-checked on refresh
Automation = 0.0 ÷ 20 × 100 = 0.0