docs(www): SEO + AEO audit fixes (sitemap, robots, JSON-LD, noindex deprecated)#94
Draft
bholmesdev wants to merge 1 commit intomainfrom
Draft
docs(www): SEO + AEO audit fixes (sitemap, robots, JSON-LD, noindex deprecated)#94bholmesdev wants to merge 1 commit intomainfrom
bholmesdev wants to merge 1 commit intomainfrom
Conversation
- Configure site URL (https://simple-stack.dev) and add @astrojs/sitemap so canonical URLs and a sitemap-index.xml are generated at build time. - Add public/robots.txt that allows all crawlers and references the sitemap. - Inject Organization JSON-LD, default Twitter card, og:site_name, and a sensible default robots meta site-wide via Starlight `head`. - Improve home page metadata: better description, OG title/description, and a FAQPage JSON-LD block answering the most common "what is Simple Stack / Simple Store / Simple Scope / Simple Query" questions for AEO. - Mark deprecated docs (Simple Stream and Simple Form) noindex and exclude them from the sitemap so search engines don't surface unmaintained content. Co-Authored-By: Oz <oz-agent@warp.dev>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
SEO and AEO audit pass on the
www/Starlight site, applying the most impactful fixes from the audit checklist.What changed
astro.config.mjsnow setssite: https://simple-stack.devand registers@astrojs/sitemap. Astro now emits proper<link rel="canonical">andsitemap-index.xml/sitemap-0.xmlfiles at build time.public/robots.txt. Allows all crawlers and points atsitemap-index.xml.headnow adds:OrganizationJSON-LD (helps AEO engines disambiguate the brand)<meta name="twitter:card" content="summary_large_image"><meta property="og:site_name" content="Simple Stack"><meta name="robots" content="index, follow, max-image-preview:large">src/content/docs/index.mdx).head.titleoverride (Starlight already produces a good<title>).descriptionfor SEO snippet quality.FAQPageJSON-LD block answering "What is Simple Stack / Store / Scope / Query / which packages are maintained?" — exactly the kind of content ChatGPT, Perplexity, and Google AI Overviews extract as citations.stream.md,form/index.mdx,form/parse.md, andform/client.mdnow set<meta name="robots" content="noindex, follow">via frontmatter, and the sitemapfilterexcludes/streamand/formso search engines aren't pointed at unmaintained pages.Verification
pnpm buildsucceeds; the build emits:dist/sitemap-index.xml+dist/sitemap-0.xmlcontaining only/,/store/,/scope/,/query/(deprecated paths excluded).dist/robots.txtreferencing the sitemap index.<link rel="canonical">,og:site_name,twitter:card, and anOrganizationJSON-LD block. The home page additionally includes a validFAQPageJSON-LD block (5 Q/As).dist/stream/index.htmland the form pages emit<meta name="robots" content="noindex, follow">.Audit items not addressed in this PR
summary_large_image). Adding a 1200×630 PNG underpublic/plusog:imagewould be a worthwhile follow-up.Conversation: https://app.warp.dev/conversation/2b41f4aa-fadf-4739-a283-86d7ed4ec930
Run: https://oz.warp.dev/runs/019dd877-811d-770c-99ac-c7227e13a223
This PR was generated with Oz.