Skip to content

Fix docs sitemap dates in shallow builds - #85

Open
nguyenm7 wants to merge 2 commits into
mainfrom
LOOA-931-verify-post-merge-production-and-repair-docs-sitemap-lastmod
Open

Fix docs sitemap dates in shallow builds#85
nguyenm7 wants to merge 2 commits into
mainfrom
LOOA-931-verify-post-merge-production-and-repair-docs-sitemap-lastmod

Conversation

@nguyenm7

@nguyenm7 nguyenm7 commented Aug 6, 2026

Copy link
Copy Markdown
Contributor

Summary

  • detect shallow Git history before deriving docs sitemap lastmod
  • fetch complete current-branch history once, then compute stable per-document dates
  • omit lastmod instead of publishing false deployment-wide freshness if history cannot be completed
  • add a reproducible two-sitemap production crawler and the LOOA-931 evidence report

Root cause

Cloudflare's depth-1 checkout makes the boundary commit look like the latest available commit for every Markdown path. Production therefore publishes 2026-07-30 for all 184 docs URLs.

Verification

  • npm run docs:test:static-routes
  • npm run sync:lint-links
  • npm run docs:build
  • committed depth-1 clone: shallow true → false, 184/184 dates, 24 distinct dates
  • production crawl: 244/244 URLs HTTP 200, indexable, and self-canonical; no sitemap URL redirects or soft-404 candidates
  • git diff --check

Impact

No URL, content, canonical, robots, sitemap-membership, or visible-page change. Expected sitemap movement is one deployment-wide docs date to multiple content-history dates. Search/ranking movement is unproven and will be measured separately.

Review gate

Do not merge or deploy without Dotta/repository-maintainer approval. Preview sitemap verification is required before this draft becomes merge-ready.

Co-Authored-By: Paperclip <noreply@paperclip.ing>
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Aug 6, 2026

Copy link
Copy Markdown

Deploying paperclip-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: 6cd6cff
Status: ✅  Deploy successful!
Preview URL: https://7aebc2b4.paperclip-docs-74t.pages.dev
Branch Preview URL: https://looa-931-verify-post-merge-p.paperclip-docs-74t.pages.dev

View logs

Co-Authored-By: Paperclip <noreply@paperclip.ing>
@nguyenm7
nguyenm7 marked this pull request as ready for review August 6, 2026 05:30
@nguyenm7
nguyenm7 requested a review from cryppadotta August 6, 2026 05:30
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.

2 participants