8000
Skip to content

docs: fix sitemap and RSS feed 404s#23585

Merged
pelikhan merged 2 commits intomainfrom
copilot/update-multi-device-docs-testing-report
Mar 30, 2026
Merged

docs: fix sitemap and RSS feed 404s#23585
pelikhan merged 2 commits intomainfrom
copilot/update-multi-device-docs-testing-report

Conversation

Copy link
Copy Markdown
Contributor
Copilot AI commented Mar 30, 2026

The docs site was missing two generated assets — sitemap-index.xml (referenced in HTML head for SEO) and blog/rss.xml (linked from blog nav) — because neither integration was wired up.

Changes

  • astro.config.mjs: Import and register @astrojs/sitemap in the integrations array; Astro will now emit /gh-aw/sitemap-index.xml at build time
  • package.json: Add @astrojs/sitemap and @astrojs/rss as explicit direct dependencies

Both packages were already present in package-lock.json as transitive deps (@astrojs/starlight@astrojs/sitemap, starlight-blog@astrojs/rss), so no new packages are introduced — the RSS feed was already being generated by starlight-blog but the dependency was implicit.

Copilot AI changed the title [WIP] Update multi-device docs testing report for 2026-03-30 docs: fix sitemap and RSS feed 404s Mar 30, 2026
Copilot AI requested a review from pelikhan March 30, 2026 21:03
@github-actions

This comment has been minimized.

@github-actions
Copy link
Copy Markdown
Contributor

Hey @Copilot 👋 — nice work tracking down the missing sitemap and RSS feed wiring! The explanation of these being promoted from transitive to explicit direct deps is especially helpful context for reviewers.

A couple of things worth addressing before this moves out of draft:

  • Add a Playwright test — the project already has E2E tests in docs/tests/ (e.g., homepage-links.spec.ts, copy-button.spec.ts) driven by npm test. A test that confirms /gh-aw/sitemap-index.xml and /gh-aw/blog/rss.xml respond with 200 would validate the fix and prevent regressions. Without coverage, a future config change could silently re-break these endpoints.
  • New deps in manifest — while the PR body explains these packages were already present as transitive deps, adding them explicitly to package.json still warrants a maintainer sign-off per project guidelines. The clear explanation in the PR description helps a lot here.

If you'd like a hand getting test coverage in place, here's a prompt you can assign to your coding agent:

Create a new Playwright test file at docs/tests/seo-feeds.spec.ts that verifies /gh-aw/sitemap-index.xml and /gh-aw/blog/rss.xml both respond with HTTP 200.

Generated by Contribution Check ·

@pelikhan pelikhan marked this pull request as ready for review March 30, 2026 21:21
Copilot AI review requested due to automatic review settings March 30, 2026 21:21
Copy link
Copy Markdown
Contributor
Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR wires up missing SEO/discovery assets for the Astro-based docs site by explicitly enabling sitemap generation and making RSS/sitemap dependencies explicit.

Changes:

  • Register @astrojs/sitemap in astro.config.mjs integrations so sitemap-index.xml is emitted at build time.
  • Add @astrojs/sitemap and @astrojs/rss as direct dependencies in package.json.
  • Update package-lock.json to reflect the new direct dependency declarations.

Reviewed changes

Copilot reviewed 2 out of 3 changed files in this pull request and generated no comments.

File Description
docs/astro.config.mjs Imports and registers the sitemap integration to generate the sitemap index during builds.
docs/package.json Declares @astrojs/rss and @astrojs/sitemap as direct dependencies for explicit/robust installs.
docs/package-lock.json Records the dependency spec additions at the workspace root.
Files not reviewed (1)
  • docs/package-lock.json: Language not supported

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@pelikhan pelikhan merged commit 58d3529 into main Mar 30, 2026
67 checks passed
@pelikhan pelikhan deleted the copilot/update-multi-device-docs-testing-report branch March 30, 2026 21:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

🔍 Multi-Device Docs Testing Report - 2026-03-30

3 participants

0