Skip to content

Add stitched sitemap index (OPE-227)#2129

Merged
desimone merged 2 commits intomainfrom
bdd/ope-227-sitemap-index
Mar 23, 2026
Merged

Add stitched sitemap index (OPE-227)#2129
desimone merged 2 commits intomainfrom
bdd/ope-227-sitemap-index

Conversation

@desimone
Copy link
Copy Markdown
Contributor

Summary

  • Adds a static sitemap.xml index at the site root referencing 3 child sitemaps:
    • https://www.pomerium.com/docs/sitemap.xml (215 docs URLs)
    • https://www.pomerium.com/marketing-sitemap.xml (507 marketing URLs from Fixel)
    • https://discuss.pomerium.com/sitemap.xml (202 forum URLs)
  • This file is inert until the companion infra-terraform PR removes the LB redirect and routes /sitemap.xml to Netlify

Context

GSC SEO audit found that the LB redirects /sitemap.xml/docs/sitemap.xml, hiding 507 marketing URLs (blog, glossary, comparisons) and 202 discuss URLs from crawlers. Fixel already generates a marketing sitemap — we just need to stop overriding it.

Linear: OPE-227

Test plan

  • Verify yarn build succeeds and build/sitemap.xml contains the sitemap index
  • Merge this first, then apply the infra-terraform LB change
  • After both deploy: curl -s https://www.pomerium.com/sitemap.xml returns the index
  • Submit to GSC and verify all 3 child sitemaps are discovered

AI disclosure

Claude drafted the sitemap index XML. Bobby reviewed and approved the approach.

…itemaps

OPE-227: The LB currently redirects /sitemap.xml to /docs/sitemap.xml,
hiding 507 marketing URLs and 202 discuss URLs from crawlers. This static
sitemap index file will be served at /sitemap.xml (once the LB redirect is
removed in the infra-terraform PR) and references all three child sitemaps.

AI-assisted: Claude drafted the sitemap index XML. Bobby reviewed.
@desimone desimone requested a review from a team as a code owner March 23, 2026 16:48
@desimone desimone requested review from kenjenkins and removed request for a team March 23, 2026 16:48
@netlify
Copy link
Copy Markdown

netlify bot commented Mar 23, 2026

Deploy Preview for pomerium-docs ready!

Name Link
🔨 Latest commit aa72cd3
🔍 Latest deploy log https://app.netlify.com/projects/pomerium-docs/deploys/69c170ecf187150008f63875
😎 Deploy Preview https://deploy-preview-2129--pomerium-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

The static sitemap index XML contains 'sitemapindex' which is a valid
XML element name but not a known English word.
@desimone desimone merged commit aa23102 into main Mar 23, 2026
9 checks passed
@desimone desimone deleted the bdd/ope-227-sitemap-index branch March 23, 2026 17:03
@backport-actions-token
Copy link
Copy Markdown

The backport to 0-32-0 failed:

The process '/usr/bin/git' failed with exit code 1

To backport manually, run these commands in your terminal:

# Fetch latest updates from GitHub
git fetch
# Create a new working tree
git worktree add .worktrees/backport-0-32-0 0-32-0
# Navigate to the new working tree
cd .worktrees/backport-0-32-0
# Create a new branch
git switch --create backport-2129-to-0-32-0
# Cherry-pick the merged commit of this pull request and resolve the conflicts
git cherry-pick --mainline 1 aa2310277d0fc6d8e3e1dd6153f46188b76a4737
# Push it to GitHub
git push --set-upstream origin backport-2129-to-0-32-0
# Go back to the original working tree
cd ../..
# Delete the working tree
git worktree remove .worktrees/backport-0-32-0

Then, create a pull request where the base branch is 0-32-0 and the compare/head branch is backport-2129-to-0-32-0.

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.

2 participants