Skip to content

Add /sitemap.xml alias and strengthen README GEO/brand signals#32862

Closed
Copilot wants to merge 2 commits into
mainfrom
copilot/plan-add-sitemap-and-improve-readme
Closed

Add /sitemap.xml alias and strengthen README GEO/brand signals#32862
Copilot wants to merge 2 commits into
mainfrom
copilot/plan-add-sitemap-and-improve-readme

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented May 17, 2026

This addresses the docs sitemap discoverability gap (/sitemap.xml returning 404) and improves README entity signals called out in the GEO audit (freshness, RSS, and sameAs-style references).

  • Sitemap discoverability

    • Added a static docs alias at docs/public/sitemap.xml that points crawlers to the generated Astro sitemap index.
    • Keeps existing @astrojs/sitemap output model (sitemap-index.xml + shard files) unchanged.
  • Robots sitemap alignment

    • Updated docs/public/robots.txt to advertise:
      • https://github.github.com/gh-aw/sitemap.xml
    • Ensures the declared sitemap URL matches an address that resolves directly.
  • README GEO / entity signal upgrades

    • Added a visible freshness marker (Last updated).
    • Added docs RSS link (/blog/rss.xml).
    • Added a compact sameAs-style “Find us” link set (repo/org/topic surface).
    • Documented canonical-meta limitation for GitHub-rendered README pages.
<!-- docs/public/sitemap.xml -->
<?xml version="1.0" encoding="UTF-8"?>
<sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
  <sitemap>
    <loc>https://github.github.com/gh-aw/sitemap-index.xml</loc>
  </sitemap>
</sitemapindex>

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Copilot AI changed the title [WIP] Fix missing sitemap and improve README brand signals Add /sitemap.xml alias and strengthen README GEO/brand signals May 17, 2026
Copilot AI requested a review from pelikhan May 17, 2026 17:14
@github-actions
Copy link
Copy Markdown
Contributor

Hey @copilot-swe-agent 👋 — thanks for picking up the sitemap and README brand signal work! A few things to address before this is ready for review:

  • No diff yet — the PR currently has 0 changed files and 0 lines modified. The task checklist in the body is a good plan, but the actual implementation needs to land before this can be evaluated. Mark the PR ready-for-review once the changes are committed.
  • Split the concerns — this PR mixes two distinct areas: (1) fixing the missing /sitemap.xml in the Astro docs build and (2) improving README brand/entity signals (freshness date, RSS link, sameAs). These are independently deployable — consider opening one PR per concern so reviewers can focus and roll back cleanly if needed.
  • Add a real description — the PR body is currently just an agent task checklist. Replace or supplement it with a brief human-readable summary: what is broken/missing, why it matters, and what specifically was changed.
  • Tests / validation — once changes land, include evidence of validation (e.g. that /sitemap.xml resolves, or a build output snippet).

If you'd like a hand completing this, assign the following to your coding agent:

This is a draft WIP PR on branch `copilot/plan-add-sitemap-and-improve-readme`.

Please complete the following two tasks, ideally in separate commits:

1. **Sitemap fix**: Ensure the Astro docs site emits a valid `/sitemap.xml` and that `robots.txt` references it correctly. Verify by running the Astro build and confirming the file is present in the output.

2. **README brand signals**: Add a freshness date, an RSS feed link, and sameAs brand/entity structured-data links to the project README.

After each change, run the relevant build/lint/validation commands to confirm nothing is broken. Update the PR body with a plain-language summary of what was changed and why.

Generated by ✅ Contribution Check · ● 13.3M ·

@pelikhan pelikhan marked this pull request as ready for review May 17, 2026 17:44
Copilot AI review requested due to automatic review settings May 17, 2026 17:44
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

Adds a static /sitemap.xml alias in the docs site to fix a 404 on that path, repoints robots.txt at that new alias, and inserts a "GEO/entity signals" block (freshness date, RSS link, schema.org-style sameAs link list, and a canonical-meta note) near the top of the README.

Changes:

  • New docs/public/sitemap.xml static file that wraps the existing sitemap-index.xml in a one-entry sitemap index.
  • docs/public/robots.txt Sitemap: directive switched from sitemap-index.xml to the new /sitemap.xml alias.
  • README prepended with a Last-updated date, RSS link, a Find us (sameAs) link list, and an HTML comment about canonical meta tag limitations.
Show a summary per file
File Description
README.md Adds freshness date, RSS link, sameAs-style link list, and canonical-meta HTML comment above the existing release note.
docs/public/sitemap.xml New static sitemap-index that points at sitemap-index.xml to make /sitemap.xml resolve.
docs/public/robots.txt Updates the advertised Sitemap: URL to the new /sitemap.xml alias.

Copilot's findings

Tip

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

  • Files reviewed: 3/3 changed files
  • Comments generated: 4

Comment thread README.md

Write agentic workflows in natural language markdown, and run them in GitHub Actions.

**Last updated:** 2026-05-17
Comment thread README.md
**Find us (sameAs):**
- [GitHub repository](https://github.com/github/gh-aw)
- [GitHub organization](https://github.com/github)
- [GitHub CLI extension listing](https://github.com/topics/gh-extension)
Comment thread docs/public/sitemap.xml
<?xml version="1.0" encoding="UTF-8"?>
<sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
<sitemap>
<loc>https://github.github.com/gh-aw/sitemap-index.xml</loc>
Comment thread docs/public/robots.txt
Allow: /

Sitemap: https://github.github.com/gh-aw/sitemap-index.xml
Sitemap: https://github.github.com/gh-aw/sitemap.xml
@pelikhan pelikhan closed this May 17, 2026
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.

[plan] GEO: Add sitemap.xml, generate sitemap, and improve README brand signals

3 participants