Skip to content

docs: add sitemap + robots.txt for search-engine indexing - #1528

Merged
rumblefrog merged 1 commit into
mainfrom
docs/sitemap-robots-seo
Jul 9, 2026
Merged

rumblefrog merged 1 commit into
mainfrom
docs/sitemap-robots-seo

Conversation

@rumblefrog

Copy link
Copy Markdown
Member

Summary

  • Register the @astrojs/sitemap integration in docs/astro.config.mjs. The docs build now emits /sitemap-index.xml and Starlight auto-injects <link rel="sitemap"> into every page's <head>.
  • Add docs/public/robots.txt (allow-all crawl + Sitemap: pointer), served at the site root.
  • Declare @astrojs/sitemap as a direct dependency (already resolved transitively via Starlight; one-line lockfile change).
  • Document both in docs/README.md.

Standard SEO fundamentals so search engines reliably discover and index the documentation pages. No page content or UI changes.

Test plan

  • npm run build in docs/ succeeds and logs [@astrojs/sitemap] `sitemap-index.xml` created
  • dist/sitemap-index.xml + dist/sitemap-0.xml generated, covering all 25 pages
  • dist/robots.txt served at root with the Sitemap: directive
  • <link rel="sitemap" href="/sitemap-index.xml"> present in built page <head>

Register the @astrojs/sitemap integration so the docs build emits
sitemap-index.xml (Starlight auto-injects <link rel="sitemap"> into
every page's <head>), and ship a public/robots.txt that allows a full
crawl and points at the sitemap. Declares @astrojs/sitemap as a direct
dependency (already resolved transitively) and documents both in the
docs README. Helps search engines reliably discover and index the
documentation pages.
Copilot AI review requested due to automatic review settings July 9, 2026 02:11

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

@rumblefrog
rumblefrog added this pull request to the merge queue Jul 9, 2026
Merged via the queue into main with commit d29d112 Jul 9, 2026
2 of 3 checks passed
@rumblefrog
rumblefrog deleted the docs/sitemap-robots-seo branch July 9, 2026 02:13
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.

2 participants