Skip to content

feat(docs): maximize SEO discoverability#58

Merged
rhuanbarreto merged 2 commits into
mainfrom
claude/adoring-gauss
Mar 15, 2026
Merged

feat(docs): maximize SEO discoverability#58
rhuanbarreto merged 2 commits into
mainfrom
claude/adoring-gauss

Conversation

@rhuanbarreto

Copy link
Copy Markdown
Contributor

Summary

  • Add robots.txt, llms.txt, OG image (1200x630), and branded SVG favicon as static assets
  • Add JSON-LD structured data globally (WebSite + SoftwareApplication schemas) and per-page (BreadcrumbList + TechArticle) via a custom Starlight HeadSEO component override
  • Add Open Graph image, Twitter card, author, theme-color, and keywords meta tags to the global Starlight head config
  • Rewrite all 40 page descriptions (20 EN + 20 PT-BR) to be 140-160 chars, keyword-rich, with action verbs and "Archgate" branding

SEO techniques applied

Technique Google/Bing AI Search (ChatGPT/Perplexity) Social (Twitter/LinkedIn)
robots.txt + sitemap Rich crawling Crawl guidance
llms.txt Full site context
JSON-LD structured data Rich results / sitelinks Enhanced context
OG image + Twitter card Click-through previews
Keyword-rich descriptions SERP snippets Context for answers Link previews
hreflang (existing) International SEO
BreadcrumbList schema Breadcrumb rich results
TechArticle schema Article rich results
SoftwareApplication schema Software rich results

Test plan

  • bun run validate passes (lint, typecheck, format, tests, ADR check, build)
  • docs build succeeds — 41 pages, 2 languages indexed
  • Verified JSON-LD in generated HTML: 2 global schemas on home, 4 schemas (global + BreadcrumbList + TechArticle) on subpages
  • Verified OG image, Twitter card, keywords, author, theme-color meta tags in output
  • Verified robots.txt, llms.txt, favicon.svg, og-image.png in dist/
  • Validate structured data with Google Rich Results Test after deploy
  • Submit sitemap to Google Search Console after deploy

🤖 Generated with Claude Code

rhuanbarreto and others added 2 commits March 15, 2026 21:57
Add comprehensive SEO infrastructure for search engine and AI search
discoverability:

- robots.txt allowing all crawlers with sitemap reference
- llms.txt for AI search engines (ChatGPT, Perplexity, etc.)
- OG image (1200x630 PNG) with generation script for social sharing
- Branded SVG favicon with Archgate indigo gradient
- JSON-LD structured data: WebSite, SoftwareApplication (global),
  BreadcrumbList and TechArticle (per-page via HeadSEO component)
- Open Graph image, Twitter card, author, theme-color, keywords meta tags
- SEO-optimized descriptions (140-160 chars, keyword-rich) for all 40
  pages (20 English + 20 Portuguese)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Replace placeholder favicon and OG image with the actual branded assets
from the website repository. The OG image generation script now reads
the branded SVG source and converts to PNG via sharp.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying cli with  Cloudflare Pages  Cloudflare Pages

Latest commit: 4d866e5
Status:⚡️  Build in progress...

View logs

@rhuanbarreto rhuanbarreto merged commit 4d8b04e into main Mar 15, 2026
6 of 7 checks passed
@rhuanbarreto rhuanbarreto deleted the claude/adoring-gauss branch March 15, 2026 21:09
@github-actions github-actions Bot mentioned this pull request Mar 15, 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.

1 participant