docs: improve docs SEO and GEO

[y2hlbg]

Summary

• add shared SEO metadata and JSON-LD helpers for docs routes
• add robots.txt and llms.txt crawl/GEO surfaces
• add six bilingual blog pairs and related-reading internal links
• remove runtime Google Fonts dependencies from the docs export

Validation

• pnpm --dir apps/docs build
• task verify-docs
• git diff --check
• verified generated sitemap.xml includes the new bilingual blog URLs and hreflang alternates

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
one-cli-docs	Ready	Preview, Comment	May 17, 2026 4:57pm

[Copilot]

Pull request overview

This PR enhances the docs site’s SEO/GEO surface area by introducing shared metadata + JSON-LD helpers, publishing crawlable agent-facing content (llms.txt / robots), adding bilingual blog content, and removing runtime Google Fonts dependencies to keep static exports self-contained.

Changes:

• Introduces a centralized SEO helper module for Next.js Metadata and JSON-LD generation, then adopts it across key routes.
• Adds robots and llms.txt surfaces and updates sitemap generation to reuse shared site constants.
• Adds bilingual blog post pairs plus “related reading” internal links; removes runtime Google Fonts loading in the docs layout.

Reviewed changes

Copilot reviewed 25 out of 25 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
apps/docs/src/lib/seo.ts	Adds shared site constants, Metadata factory, and JSON-LD helpers (Website/SoftwareApplication/Article/Breadcrumb/ItemList).
apps/docs/src/app/sitemap.ts	Reuses shared siteUrl constant for sitemap absolute URLs.
apps/docs/src/app/robots.ts	Adds a static robots.txt endpoint with sitemap + host.
apps/docs/src/app/layout.tsx	Removes runtime Google Fonts usage and centralizes base metadata values.
apps/docs/src/app/global.css	Switches font variables to system stacks to avoid third-party font fetches.
apps/docs/src/app/[lang]/tutorials/[[...slug]]/page.tsx	Uses shared metadata helper and injects JSON-LD (TechArticle + breadcrumbs) for tutorials.
apps/docs/src/app/[lang]/templates/page.tsx	Uses shared metadata helper and injects ItemList JSON-LD for template examples index.
apps/docs/src/app/[lang]/templates/[id]/page.tsx	Uses shared metadata helper and injects JSON-LD (ItemList + breadcrumbs) for template example detail.
apps/docs/src/app/[lang]/docs/[[...slug]]/page.tsx	Uses shared metadata helper and injects JSON-LD (TechArticle + breadcrumbs) for docs pages.
apps/docs/src/app/[lang]/blog/page.tsx	Uses shared metadata helper and injects ItemList JSON-LD for blog index.
apps/docs/src/app/[lang]/blog/[slug]/page.tsx	Uses shared metadata helper, injects BlogPosting JSON-LD + breadcrumbs, and adds “related reading” section.
apps/docs/src/app/(home)/home-page.tsx	Uses shared metadata helper and injects WebSite + SoftwareApplication JSON-LD on localized home.
apps/docs/public/llms.txt	Adds an LLM-oriented crawl surface with canonical links and recommended entry points.
apps/docs/content/blog/zh/template-governance-for-ai-workspaces.md	Adds new Chinese blog post.
apps/docs/content/blog/zh/one-cli-vs-general-scaffolding.md	Adds new Chinese blog post.
apps/docs/content/blog/zh/monorepo-scaffold-manifest.md	Adds new Chinese blog post.
apps/docs/content/blog/zh/json-cli-contracts-for-agents.md	Adds new Chinese blog post.
apps/docs/content/blog/zh/coding-agent-workspace-setup.md	Adds new Chinese blog post.
apps/docs/content/blog/zh/ai-native-monorepo-cli.md	Adds new Chinese blog post.
apps/docs/content/blog/en/template-governance-for-ai-workspaces.md	Adds new English blog post.
apps/docs/content/blog/en/one-cli-vs-general-scaffolding.md	Adds new English blog post.
apps/docs/content/blog/en/monorepo-scaffold-manifest.md	Adds new English blog post.
apps/docs/content/blog/en/json-cli-contracts-for-agents.md	Adds new English blog post.
apps/docs/content/blog/en/coding-agent-workspace-setup.md	Adds new English blog post.
apps/docs/content/blog/en/ai-native-monorepo-cli.md	Adds new English blog post.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Just as a heads up, I was blocked by some firewall rules while working on your feedback. Expand below for details.

[Copilot]

Just as a heads up, I was blocked by some firewall rules while working on your feedback. Expand below for details.