Skip to content

Add JSON-LD structured data (TechArticle + BreadcrumbList) to docs pages#190

Open
Copilot wants to merge 6 commits into
masterfrom
copilot/add-json-ld-structured-data
Open

Add JSON-LD structured data (TechArticle + BreadcrumbList) to docs pages#190
Copilot wants to merge 6 commits into
masterfrom
copilot/add-json-ld-structured-data

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented May 21, 2026

Documentation pages emitted standard <meta> tags but no machine-readable structured data, limiting SEO and rich-snippet eligibility in search results.

Changes

  • New dependencyastro-seo-schema@6.0.0 (zero-dep, MIT) added to root package.json
  • src/components/overrides/Head.astro (new) — Renders two JSON-LD blocks into <head> per page:
    • TechArticleheadline, description, and canonical url
    • BreadcrumbList — full trail from site root to current page, derived from the sidebar tree via the existing getBreadcrumb helper; only emitted when ≥2 crumbs are present
  • src/routes/[...slug].astro — Injects Head via the head slot on DocsLayout
<DocsLayout ...>
  <Head slot="head" title={title} description={description} currentSlug={currentSlug} />
  ...
</DocsLayout>

Both schema blocks are conditionally rendered — TechArticle requires a title, BreadcrumbList requires a resolved sidebar trail.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

  • telemetry.astro.build
    • Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node node /home/REDACTED/work/igniteui-documentation/igniteui-documentation/node_modules/.bin/astro check (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

Copilot AI changed the title [WIP] Add JSON-LD structured data headers for Astro docs pages Add JSON-LD structured data (TechArticle + BreadcrumbList) to docs pages May 21, 2026
Copilot AI requested a review from ChronosSF May 21, 2026 15:25
@ChronosSF ChronosSF marked this pull request as ready for review May 22, 2026 07:55
@ChronosSF ChronosSF added the ✅ status: verified Applies to PRs that have passed manual verification label May 22, 2026
@ChronosSF ChronosSF requested a review from dobromirts May 22, 2026 07:55
Comment thread src/components/overrides/Head.astro Outdated
Co-authored-by: Dobromir Tsvetkov <46093564+dobromirts@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

✅ status: verified Applies to PRs that have passed manual verification

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Implement JSON-LD structured data headers for Astro docs pages

3 participants