Skip to content

[plan] Fix sitemap generation on docs site (Astro Starlight) #30481

@github-actions

Description

@github-actions

From the GEO Audit Report (discussion #30401): https://github.github.com/gh-aw/sitemap.xml returns 404, preventing AI crawlers from discovering interior pages.

Approach

  1. Open docs/astro.config.mjs and check if @astrojs/sitemap integration is present
  2. Add the sitemap integration if missing:
    import sitemap from '`@astrojs/sitemap`';
    export default defineConfig({ site: 'https://github.github.com/gh-aw', integrations: [sitemap()] });
  3. Ensure site property is set correctly (required for sitemap generation)
  4. Verify the built output includes sitemap.xml and a <link rel="sitemap"> tag in <head>

Files to Modify

  • docs/astro.config.mjs — add/fix sitemap integration and site URL
  • docs/package.json — add @astrojs/sitemap dependency if missing

Acceptance Criteria

  • sitemap.xml is generated in the docs build output
  • <link rel="sitemap" href="/sitemap-index.xml"> is present in page <head>
  • docs/astro.config.mjs includes sitemap integration with correct site URL

Generated by Plan Command for issue #discussion #30401 · ● 2.8M ·

  • expires on May 8, 2026, 1:52 AM UTC

Metadata

Metadata

Labels

Type

No type
No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions