Skip to content

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

Closed

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

Activity

  1. github-actions commented on May 6, 2026

    @github-actions
    ContributorAuthor

    🍪 Issue Monster selected this for Copilot

    I've identified this issue as a good candidate for automated resolution and requested assignment to the Copilot coding agent.

    If assignment succeeds, the Copilot coding agent will analyze the issue and create a pull request with the fix.

    Om nom nom! 🍪

    🍪 Om nom nom by Issue Monster · ● 71.5K · ◷

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions