docs site: no structured data (JSON-LD) anywhere

[os-zhuang]

One-liner

The site emits no JSON-LD at all, so Google has to infer what ObjectStack is and where each doc page sits, and the docs are ineligible for breadcrumb rich results.

Expected

• Homepage: SoftwareApplication (or SoftwareSourceCode) + Organization — name, url, logo, license Apache-2.0, sameAs pointing at the GitHub org and the YouTube channel (https://www.youtube.com/@objectstack).
• Doc pages: TechArticle (headline, description, dateModified from the same git signal the sitemap uses) + BreadcrumbList derived from source.pageTree — breadcrumbs are the piece that actually shows up in results.
• Blog posts: BlogPosting.
• Emit via a <script type="application/ld+json"> in the layout/page, generated from the same page data as the metadata so the two can never disagree.

Depends on the metadataBase card for absolute URLs.

Acceptance

• a doc page, the homepage and a blog post each validate clean in Google's Rich Results Test
• every URL inside the JSON-LD is absolute and on objectstack.ai
• dateModified matches the sitemap's lastModified for the same page

Source

Found in an SEO review of the docs site (apps/docs) run on 2026-08-25, measured against the local dev server and against production. The canonical origin is https://objectstack.ai — maintainer ruling recorded in #10659:

这个仓的文档站规范 URL 是 https://objectstack.ai

[os-zhuang]

⚠️ Trap carried in from #12232's dev report — read before starting this card.

apps/docs/app/page.tsx is a shadowed route: proxy.ts rewrites / to /en, so RootPage() never runs (measured: curl / returns 200 text/html, not the 307 that file would produce). Filed standalone as #12255.

What it means here: the homepage's real metadata lives in apps/docs/app/[lang]/page.tsx. An agent that adds JSON-LD to app/page.tsx will ship a green PR that changes nothing served. Verify against a rendered response, not against the file you edited.

The epic does not depend on #12255 being fixed — it stays a standalone finding — but this card does depend on knowing about it.