Skip to content

feat(seo): BreadcrumbList JSON-LD site-wide + TechArticle on integrations - #73

Merged
nibzard merged 1 commit into
mainfrom
niko/seo-jsonld
Jul 23, 2026
Merged

feat(seo): BreadcrumbList JSON-LD site-wide + TechArticle on integrations#73
nibzard merged 1 commit into
mainfrom
niko/seo-jsonld

Conversation

@nibzard

@nibzard nibzard commented Jul 23, 2026

Copy link
Copy Markdown
Contributor

What

Technical fix #2 from SEO-OPPORTUNITIES.md (Days 0–14): structured data beyond the existing FAQPage.

  • BreadcrumbList on every docs page — home + section hub + ancestor pages + the page. Fumadocs resets breadcrumb trails at root: true section folders, so the section crumb is prepended manually from the section's index page. Folders without an index page are dropped (Google requires item on every ListItem except the last).
  • TechArticle on /integrations/* leaf pages — Organization author (Steel), datePublished from frontmatter publishedAt when present, dateModified from git history. Cookbook recipes already emit TechArticle via RecipeJsonLd (per-author Person entries), and the /integrations hub is a listing, so both are excluded.
  • lib/last-modified.ts — git-date helper extracted from app/sitemap.ts, now shared.

Verified

Dev-server smoke test across page shapes:

Page Trail
/integrations/selenium Steel Docs › Integrations › Run Selenium in the Cloud on Steel
/cookbook/scrape Steel Docs › Cookbook › Scrape JavaScript-Rendered Pages to Markdown
/cookbook/topics/agents Steel Docs › Cookbook › Agents
/overview/stealth/proxies Steel Docs › Proxies & Proxy Rotation... (no /overview hub page exists)
/integrations (hub) Steel Docs › Integrations

TechArticle on selenium page carries description + dateModified: 2026-07-23; existing FAQPage JSON-LD unaffected. sitemap.xml still serves 149 URLs after the helper extraction. Biome clean.

…tegrations

Second Days-0-14 item from SEO-OPPORTUNITIES.md (technical fix #2):

- components/page-jsonld.tsx: BreadcrumbJsonLd + TechArticleJsonLd
- app/[...slug]/page.tsx emits BreadcrumbList on every docs page:
  home + section hub + ancestor pages + the page. Fumadocs resets
  trails at root section folders, so the section crumb is prepended
  manually from the section index page. Url-less folders are dropped
  (Google requires item on all but the last ListItem).
- TechArticle on /integrations/* leaf pages with Organization author,
  frontmatter publishedAt, and git-derived dateModified. Cookbook
  recipes already emit TechArticle via RecipeJsonLd; the /integrations
  hub is a listing, so it is excluded.
- lib/last-modified.ts: git-date helper extracted from app/sitemap.ts,
  now shared by the sitemap and the TechArticle dateModified.
@vercel

vercel Bot commented Jul 23, 2026

Copy link
Copy Markdown
Contributor

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

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment Jul 23, 2026 4:14pm

Request Review

@nibzard
nibzard merged commit 8493afa into main Jul 23, 2026
3 checks passed
@nibzard
nibzard deleted the niko/seo-jsonld branch July 23, 2026 16:19
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