Skip to content

docs(deployment): sitemap + Google Search Console workflow (#1313)#1323

Merged
jonfroehlich merged 2 commits into
masterfrom
1313-sitemap-search-console-docs
Jun 17, 2026
Merged

docs(deployment): sitemap + Google Search Console workflow (#1313)#1323
jonfroehlich merged 2 commits into
masterfrom
1313-sitemap-search-console-docs

Conversation

@jonfroehlich

Copy link
Copy Markdown
Member

What

Adds a Search Engine Indexing (Sitemap & Google Search Console) subsection to docs/DEPLOYMENT.md, plus a TOC entry, covering the operational half of the sitemap work that wasn't yet written down.

Why

#1252 added the dynamic sitemap + robots.txt serving, and #1313 surfaced/resolved the prod-deploy stall that was blocking it (prod now on 2.9.0, sitemap verified live with ~718 URLs). What was missing was the operational knowledge: how to register the sitemap with Google Search Console and how often to touch it (answer: essentially never — it's DB-generated and self-updating).

Contents of the new section

  • The sitemap is dynamically generated from the DB — nothing to regenerate per content change (new people/news/pubs flow in automatically).
  • A copy-paste prod health check (curl checks for /sitemap.xml, /robots.txt, URL count).
  • One-time Google Search Console steps: URL-prefix property, ownership verification (Google Analytics or HTML-file-in-repo-root), submit sitemap.xml.
  • Ongoing cadence: near-zero; optional quarterly indexing-error check.
  • Tightened the existing routing note to record that production pages carry no X-Robots-Tag (with a verify command), complementing the existing note that the test host is never indexed.

Docs-only change; no code or behavior impact.

🤖 Generated with Claude Code

jonfroehlich and others added 2 commits June 17, 2026 15:28
…1313)

Add a "Search Engine Indexing" subsection to DEPLOYMENT.md covering the
dynamic, DB-generated sitemap (nothing to regenerate per content change),
a copy-paste prod health check, the one-time Google Search Console
registration/verification steps, and the (near-zero) ongoing cadence.
Also note that production pages carry no X-Robots-Tag, with a verify
command. Builds on the routing notes from #1252.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…h Console (#1313)

The prod site is already a verified URL-prefix property in Google Search
Console (verified via the pre-existing Google Analytics property), and the
sitemap was submitted 2026-06-17. Add a "Current status" note so nobody
re-runs verification, and reframe the registration steps as re-setup-only.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@jonfroehlich

Copy link
Copy Markdown
Member Author

Now in Google Search Console.

image

@jonfroehlich jonfroehlich merged commit e0f7e83 into master Jun 17, 2026
2 checks passed
@jonfroehlich jonfroehlich deleted the 1313-sitemap-search-console-docs branch June 17, 2026 22:54
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