Skip to content

seo: add site config, robots.txt, structured data, and improved meta descriptions#89

Open
bholmesdev wants to merge 1 commit intomainfrom
seo-aeo-audit
Open

seo: add site config, robots.txt, structured data, and improved meta descriptions#89
bholmesdev wants to merge 1 commit intomainfrom
seo-aeo-audit

Conversation

@bholmesdev
Copy link
Owner

@bholmesdev bholmesdev commented Mar 5, 2026

SEO & AEO Audit: simple-stack/www

Comprehensive SEO and AEO (Answer Engine Optimization) audit and fixes for the documentation site at simple-stack.dev.

Critical fixes

  • Add site property to astro.config.mjs — enables Starlight's built-in sitemap generation, canonical URLs, and fully-qualified Open Graph URLs
  • Add robots.txt — provides crawl guidance and references the auto-generated sitemap
  • Add WebSite JSON-LD structured data — site-wide via Starlight's head config, with author/person schema for AI engine trust signals

High priority improvements

  • Improved meta descriptions on all 8 pages — keyword-rich, 150-160 chars, targeting developer search queries
  • Cleaner site title — removed emoji from the Starlight title config for better SERP display
  • Improved homepage frontmatter — removed redundant <title> head override, added descriptive title and description

Medium priority fixes

  • Video fallback text on stream.md for accessibility and SEO

Remaining recommendations (not in this PR)

These are content/strategy changes best handled by the maintainer:

  • Open Graph image: Create and configure a default social preview image
  • FAQ structured data: Add FAQPage JSON-LD to documentation pages with Q&A patterns
  • Breadcrumb JSON-LD: Add BreadcrumbList schema (Starlight renders visual breadcrumbs but no structured data)
  • AEO content format: Consider leading documentation sections with 40-60 word direct answers for better AI citation
  • AI referral tracking: Monitor traffic from chat.openai.com, perplexity.ai, gemini.google.com in analytics

What this enables

After merge and deploy:

  • Sitemap auto-generated at /sitemap-index.xml
  • Canonical URLs on all pages
  • Structured data visible to Google Rich Results Test and AI engines
  • Improved click-through rates from more descriptive SERP snippets

This PR was generated with Oz.

@changeset-bot
Copy link

changeset-bot bot commented Mar 5, 2026

⚠️ No Changeset found

Latest commit: 52a8fc8

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@vercel
Copy link

vercel bot commented Mar 5, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
simple-stack-docs Ready Ready Preview, Comment Mar 23, 2026 9:05am

@bholmesdev bholmesdev changed the title feat(www): SEO & AEO audit — sitemap, robots.txt, structured data, improved meta SEO/AEO audit: add site URL, robots.txt, structured data, and improved meta descriptions Mar 6, 2026
@bholmesdev bholmesdev changed the title SEO/AEO audit: add site URL, robots.txt, structured data, and improved meta descriptions feat(www): SEO/AEO audit — site URL, robots.txt, structured data, improved meta Mar 10, 2026
@bholmesdev bholmesdev changed the title feat(www): SEO/AEO audit — site URL, robots.txt, structured data, improved meta feat(www): SEO/AEO audit — sitemap, robots.txt, structured data, improved meta Mar 11, 2026
@bholmesdev bholmesdev changed the title feat(www): SEO/AEO audit — sitemap, robots.txt, structured data, improved meta SEO/AEO audit: improve titles, descriptions, structured data, and crawlability Mar 16, 2026
@bholmesdev bholmesdev changed the title SEO/AEO audit: improve titles, descriptions, structured data, and crawlability SEO/AEO audit: site URL, robots.txt, structured data, improved descriptions Mar 17, 2026
@bholmesdev bholmesdev changed the title SEO/AEO audit: site URL, robots.txt, structured data, improved descriptions feat(www): SEO/AEO audit and optimizations Mar 18, 2026
@bholmesdev bholmesdev changed the title feat(www): SEO/AEO audit and optimizations feat(www): SEO & AEO audit improvements Mar 19, 2026
…descriptions

- Add site property to astro.config.mjs to enable sitemap and canonical URLs
- Add robots.txt with sitemap reference
- Add WebSite JSON-LD structured data via Starlight head config
- Improve meta descriptions on all pages for better keyword targeting
- Add video fallback text on stream.md
- Remove emoji from site title for cleaner SERP display

Co-Authored-By: Oz <oz-agent@warp.dev>
@bholmesdev bholmesdev changed the title feat(www): SEO & AEO audit improvements seo: add site config, robots.txt, structured data, and improved meta descriptions Mar 23, 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