Skip to content

[Trace] Noindex the empty docs.turbodocx.com root page - #176

Merged
nicolasiscoding merged 2 commits into
developfrom
trace/docs-root-noindex
Sep 23, 2026
Merged

nicolasiscoding merged 2 commits into
developfrom
trace/docs-root-noindex

Conversation

@nicolasiscoding

Copy link
Copy Markdown
Member

Closes #175

Trace task: config/noindex-strategy.json (auto-noindex under 100 rendered words) from the ai-seo-playbook, applied to the Docs site.

Evidence

https://docs.turbodocx.com/ renders ~1 word to a first-pass crawler (from /home/nicolas/.claude/jobs/4fe2c970/tmp/prune.json: words: 1, clicks90: 1, impr90: 81), well under the strategy's 100-word auto-noindex threshold and the >100 clicks/month guard.

What / turned out to be

src/pages/index.tsx is not a landing page — it renders <Redirect to="/docs" /> from @docusaurus/router, a client-side redirect to the real documentation hub at /docs (30 words, 4 clicks/90d, already indexed and fine). Crawlers that don't execute JS see an effectively empty page.

Changes

  • src/pages/index.tsx: added <meta name="robots" content="noindex, follow" /> via @docusaurus/Head.
  • docusaurus.config.js: added sitemap.ignorePatterns: ['/'] so the sitemap plugin doesn't list a page with a conflicting noindex tag (Docusaurus 3.10's sitemap plugin also auto-excludes noindexed pages at build time from rendered HTML, so this is belt-and-suspenders).

Not done here (noted in the CR)

/ is a client-side redirect, so crawlers and users still make a request to the empty stub before JS redirects them. The long-term fix is a server-side redirect (a Cloudflare Pages static/_redirects entry, / /docs 301 or similar) so nobody ever renders the stub. Out of scope for this noindex-only change; flagging for a follow-up.

Test plan

  • Internal links checked: only link touched is the implicit / route itself; no slug changes
  • No em-dashes in changed files
  • Local build / preview (not run per instructions; verify on merge)

/ renders ~1 word to a first-pass crawler: it's a client-side redirect
(<Redirect to="/docs" /> from @docusaurus/router) to the real hub at
/docs. Per config/noindex-strategy.json (auto-noindex under 100 words),
add a noindex,follow meta tag via @docusaurus/Head and exclude / from
the sitemap plugin's ignorePatterns so the two signals agree.

A server-side redirect (e.g. a Cloudflare Pages static/_redirects
entry) would be the long-term fix so crawlers and users never hit the
client-rendered stub at all, but that's out of scope here.
@nicolasiscoding nicolasiscoding self-assigned this Sep 23, 2026
@nicolasiscoding
nicolasiscoding marked this pull request as ready for review September 23, 2026 15:59
@nicolasiscoding
nicolasiscoding merged commit f14a442 into develop Sep 23, 2026
1 check passed

This branch was successfully deployed

1 active deployment
preview — 5cb1f14a Deployed Sep 23, 2026 by github-actions[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Trace] Noindex the empty docs.turbodocx.com root page

1 participant