Skip to content

SEO: audit and fixes for docs site#85

Open
bholmesdev wants to merge 1 commit intomainfrom
seo/audit-and-fixes
Open

SEO: audit and fixes for docs site#85
bholmesdev wants to merge 1 commit intomainfrom
seo/audit-and-fixes

Conversation

@bholmesdev
Copy link
Owner

SEO Audit & Fixes for www/

Comprehensive SEO audit of the Simple Stack documentation site based on Lighthouse SEO guidelines.

Changes

Critical fixes:

  • Added site: "https://simple-stack.dev" to astro.config.mjs — enables canonical URLs, Open Graph absolute URLs, and automatic sitemap generation by Starlight
  • Removed redundant <title> head override on homepage that was overriding Starlight's SEO-friendly title template

High priority:

  • Added robots.txt to public/ with sitemap reference (sitemap-index.xml is now auto-generated by Starlight)
  • Improved all page titles — removed emoji prefixes (kept in sidebar labels), added descriptive keywords (e.g. 💾 Simple storeSimple Store - Reactive State with Selectors)
  • Improved all meta descriptions — specific feature mentions, ~150 chars, compelling language

Medium priority:

  • Added Organization JSON-LD structured data via Starlight head config
  • Improved internal link anchor text on homepage from generic "Documentation" to descriptive text (e.g. "Simple Store docs and API reference")
  • Added fallback text inside <video> element in stream.md for search engine crawlers

Verification

  • Build passes with astro check && astro build — 0 errors, 0 warnings
  • Generated HTML verified to include: title tags, meta descriptions, canonical URLs, OG tags, Twitter card, JSON-LD, sitemap link

This PR was generated with Oz.

…ructured data

- Add site URL to astro.config.mjs enabling canonical URLs, OG URLs, and sitemap generation
- Add Organization JSON-LD structured data via Starlight head config
- Add robots.txt with sitemap reference
- Improve page titles: remove emoji prefixes, add descriptive keywords
- Improve meta descriptions: specific, compelling, ~150 chars with feature mentions
- Remove redundant head title override on index page
- Improve internal link anchor text from generic 'Documentation' to descriptive text
- Add video fallback text in stream.md for crawlers

Co-Authored-By: Oz <oz-agent@warp.dev>
@changeset-bot
Copy link

changeset-bot bot commented Feb 24, 2026

⚠️ No Changeset found

Latest commit: 5801642

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 Feb 24, 2026

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

Project Deployment Actions Updated (UTC)
simple-stack-docs Building Building Preview, Comment Feb 24, 2026 8:52pm

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