Skip to content

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

  • [probe] https://docusaurus.io/llms.txtPROBE llms.txt: HTTP 404 at https://docusaurus.io/llms.txt
  • [probe] https://docusaurus.io/docs.mdPROBE docs-md: HTTP 404 at https://docusaurus.io/docs.md

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/deploymentTo build the static files of your website for production, run: npm run build
  • [claimed-docs] https://docusaurus.io/docs/deploymentOnce it finishes, the static files will be generated within the `build` directory.
  • [claimed-docs] https://docusaurus.io/docs/deploymentDocusaurus provides a [`docusaurus serve`](/docs/cli#docusaurus-serve-sitedir) command for that
  • [claimed-docs] https://docusaurus.io/docs/deploymentYou 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/cliofficial CLI documented at https://docusaurus.io/docs/cli
  • [community] https://hn.algolia.com/api/v1/items/41387922I 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/41387922I 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/installationnpx create-docusaurus@latest my-website classic
  • [claimed-docs] https://docusaurus.io/docs/cliBuilds and serves a preview of your site locally with Webpack Dev Server.
  • [claimed-docs] https://docusaurus.io/docs/versioningYou 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/deploymentDocusaurus provides a [`docusaurus serve`](/docs/cli#docusaurus-serve-sitedir) command for that
  • [probe] https://docusaurus.io/docs/cliofficial 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/cliBuilds and serves a preview of your site locally with Webpack Dev Server.
  • [claimed-docs] https://docusaurus.io/docs/cliBuilds and serves a preview of your site locally with [Webpack Dev Server]
  • [claimed-docs] https://docusaurus.io/docs/deploymentDocusaurus provides a [`docusaurus serve`](/docs/cli#docusaurus-serve-sitedir) command for that
  • [claimed-docs] https://docusaurus.io/docs/using-pluginsAll 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-pluginsA plugin is usually an npm package, so you install them like other npm packages using npm.
  • [probe] https://docusaurus.io/docs/cliofficial CLI documented at https://docusaurus.io/docs/cli
  • [probe] https://docusaurus.io/llms.txtPROBE llms.txt: HTTP 404 at https://docusaurus.io/llms.txt
  • [probe] https://docusaurus.io/docs.mdPROBE docs-md: HTTP 404 at https://docusaurus.io/docs.md
  • [probe] https://docusaurus.io/openapi.jsonPROBE 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.ioExtend 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-pluginsAll 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/swizzlingswizzling permits to swap a theme component with your own implementation
  • [claimed-docs] https://docusaurus.io/docs/using-pluginsA plugin is usually an npm package, so you install them like other npm packages using npm.
  • [probe] https://docusaurus.io/docs/cliofficial CLI documented at https://docusaurus.io/docs/cli
  • [probe] https://docusaurus.io/llms.txtPROBE llms.txt: HTTP 404 at https://docusaurus.io/llms.txt
  • [probe] https://docusaurus.io/docs.mdPROBE docs-md: HTTP 404 at https://docusaurus.io/docs.md
  • [probe] https://docusaurus.io/openapi.jsonPROBE 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/reactDocusaurus 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/reactYou can also import your own components defined in other files or third-party components installed via npm.
  • [probe] https://docusaurus.io/openapi.jsonPROBE 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.jsonPROBE 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.txtPROBE llms.txt: HTTP 404 at https://docusaurus.io/llms.txt
  • [probe] https://docusaurus.io/docs.mdPROBE 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/docsDocusaurus v2+ has been a total rewrite from Docusaurus v1, taking advantage of a completely modernized toolchain.
  • [claimed-docs] https://docusaurus.io/docs/versioningYou can use the versioning CLI to create a new documentation version based on the latest content in the docs directory.
  • [claimed-docs] https://docusaurus.ioSupport 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/installationnpx create-docusaurus@latest my-website classic
  • [claimed-docs] https://docusaurus.io/docs/cliBuilds and serves a preview of your site locally with Webpack Dev Server.
  • [claimed-docs] https://docusaurus.ioExtend 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/cliofficial 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.ioSimply write docs and blog posts with MDX, and Docusaurus builds them into static HTML files ready to be served.
  • [claimed-docs] https://docusaurus.ioSimply 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/deploymentTo build the static files of your website for production, run: npm run build
  • [claimed-docs] https://docusaurus.io/docs/deploymentOnce it finishes, the static files will be generated within the `build` directory.
  • [claimed-docs] https://docusaurus.ioLocalization 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.ioUse git, Crowdin, or any other translation manager to translate your docs and deploy them individually.
  • [community] https://hn.algolia.com/api/v1/items/41387922It'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/41387922For 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/41387922It'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/32303052So 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/deploymentTo build the static files of your website for production, run: npm run build
  • [claimed-docs] https://docusaurus.io/docs/deploymentOnce it finishes, the static files will be generated within the `build` directory.
  • [claimed-docs] https://docusaurus.io/docs/deploymentYou 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/deploymentDocusaurus provides a [`docusaurus serve`](/docs/cli#docusaurus-serve-sitedir) command for that
  • [community] https://hn.algolia.com/api/v1/items/41387922It'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.ioSimply 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/cliBuilds and serves a preview of your site locally with Webpack Dev Server.
  • [claimed-docs] https://docusaurus.io/docs/versioningYou 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.txtPROBE llms.txt: HTTP 404 at https://docusaurus.io/llms.txt
  • [probe] https://docusaurus.io/docs.mdPROBE docs-md: HTTP 404 at https://docusaurus.io/docs.md
  • [probe] https://docusaurus.io/openapi.jsonPROBE 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