Skip to content

fix(search): sitemap discovery + rollout settle for the index scraper - #1271

Open
ndneighbor wants to merge 1 commit into
mainfrom
angelo/search-scraper-sitemap
Open

fix(search): sitemap discovery + rollout settle for the index scraper#1271
ndneighbor wants to merge 1 commit into
mainfrom
angelo/search-scraper-sitemap

Conversation

@ndneighbor

Copy link
Copy Markdown
Contributor

Problem

Docs search was missing most of the 38 guides merged in #1267. The index scrape (run 30519545306) completed 'successfully' at 06:25 with 33,376 records but only crawled 1 of the new guides.

Root cause: discovery is pure link-crawling from /, and the scrape fires on the deploy-success event, racing the rollout. It crawled the stale cached /guides index (pre-deploy copy with no links to the new guides), so pages only discoverable through fresh links were invisible. llm-gateway survived only because an updated page that happened to serve fresh linked it.

Fix

  • sitemap_urls: the scraper now seeds from sitemap-0.xml (371 URLs, regenerated by next-sitemap on every build), so new pages are discovered regardless of what the crawl-path caches serve.
  • Deployment-triggered scrapes wait 3 minutes before crawling so page content is also post-rollout.

Verification

A manually dispatched re-scrape (run 30575053481) is in flight against the now-fresh cache; I'll confirm the missing guides are searchable once it lands. This PR prevents the recurrence.

🤖 Generated with Claude Code

…efore scraping

The scraper discovered pages only by following links from /, so a
scrape racing a deploy crawled the stale cached /guides index and
missed most of a 38-guide batch (verified against the prod index:
llm-gateway present, code-execution-sandboxes/webhooks-at-scale/
uptime-kuma absent, run 30519545306). Discovery now also reads
sitemap-0.xml, which regenerates with every build, and
deployment-triggered scrapes wait 3 minutes for the rollout.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@railway-app

railway-app Bot commented Jul 30, 2026

Copy link
Copy Markdown

🚅 Deployed to the docs-pr-1271 environment in 🪄 *.railway.com

Service Status Web Updated (UTC)
Docs Frontend ✅ Success (View Logs) Web Jul 30, 2026 at 7:32 pm
6 services not affected by this PR
  • devicons
  • OG
  • Frontend Redis
  • Turnout
  • Meilisearch
  • Geofeed

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.

1 participant