fix(docs): build-time plugin count on the docs index

Open Beginner friendly
#5,666 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
88/100
Issue type
Bug
Clarity
Clearly specified
Activity status
Active
Tech stack
javascript
Domain
documentation

Research direction

Read src/contents/docs/index.mdx and src/components/content/PluginCount.vue, then trace fetchTotalPluginsCount() before adding the Astro component named in the issue. Build the docs and inspect dist/client/docs/index.html; done means it contains the real plugin count and the /docs Markdown no longer contains 0+.

Written by the indexing model from the issue text.

Description

area/docs area/frontend kind/website

Part of the Markdown for Agents Phase 1 epic (see #5652). kestra.io has Cloudflare Markdown for Agents enabled: Accept: text/markdown converts the SSR HTML at the edge, so defects in the HTML end up in what AI agents read. Cloudflare strips nav/header/footer/scripts/styles/inline SVG, ignores aria-hidden and empty alt, keeps .visually-hidden text and display:none content, and renders <dl> as separate lines (all verified on production).

Problem

src/contents/docs/index.mdx uses <PluginCount client:idle /> (src/components/content/PluginCount.vue), whose usePluginsCount() starts at 0+ and fetches on the client. SSR ships <span>0+</span>, so /docs reads "Thanks to 0+ plugins" in HTML and in the converted Markdown. Not covered by #5446, which fixed /enterprise and /1-0.

Scope

  • Add src/components/content/PluginCount.astro that awaits fetchTotalPluginsCount() and renders the formatted value; use it from index.mdx (Astro components work in MDX).
  • Delete PluginCount.vue and src/composables/usePluginsCount.ts in the same PR. index.mdx is the only consumer of the component, and the component is the only consumer of the composable (verified by grep on 2026-09-20); there are no subgroups callers.

Done when

  • dist/client/docs/index.html contains the real count; no 0+ in /docs Markdown.
Dominant language
Astro
Stars
155
Forks
177
Avg merge
23h 17m
Merged PRs (30d)
191

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from kestra-io/docs

All issues in kestra-io/docs

Similar issues

More Documentation issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.