Skip to content

SEO/AEO audit: site URL, robots.txt, structured data, improved descriptions#89

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

SEO/AEO audit: site URL, robots.txt, structured data, improved 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 for www/

Addresses multiple SEO and AI Engine Optimization (AEO) issues found in the documentation site.

Changes

Critical fixes:

  • Add site: 'https://simple-stack.dev' to astro.config.mjs — enables Starlight's built-in sitemap generation, canonical URL tags, and proper absolute Open Graph URLs
  • Create public/robots.txt with crawl directives and sitemap reference
  • Remove duplicate <title> override in homepage frontmatter (Starlight already generates this from title)

Structured data:

  • Add WebSite JSON-LD schema via Starlight's head config, including author info and sameAs links for AI engine entity disambiguation

Meta descriptions (AEO):

  • Rewrite all page descriptions to be self-contained, keyword-rich, and answer-first — optimized for extraction by AI engines (ChatGPT, Perplexity, Google AI Overviews)
  • Deprecated packages now explicitly mention deprecation and their replacements in the description

Accessibility:

  • Add aria-label to the video element in stream.md
  • Capitalize page titles consistently

What Starlight now auto-generates (with site configured)

  • sitemap-index.xml / sitemap-0.xml
  • <link rel="canonical"> on every page
  • <meta property="og:url">, og:title, og:description
  • <meta property="twitter:card"> tags

This PR was generated with Oz.

@changeset-bot
Copy link

changeset-bot bot commented Mar 5, 2026

⚠️ No Changeset found

Latest commit: 3eca581

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 17, 2026 9:06am

@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
…d meta descriptions

- Add site: 'https://simple-stack.dev' to astro.config.mjs to enable
  sitemap generation, canonical URLs, and proper OG tags
- Create public/robots.txt with sitemap reference
- Add WebSite JSON-LD structured data via Starlight head config
- Remove duplicate title override on homepage
- Improve meta descriptions across all pages for better search
  engine and AI engine visibility (AEO)
- Add aria-label to video element in stream.md
- Capitalize page titles consistently

Co-Authored-By: Oz <oz-agent@warp.dev>
@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
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