docs(seo): clarify the SEO panel is only honored if the page wires getSeoMeta#1519
docs(seo): clarify the SEO panel is only honored if the page wires getSeoMeta#1519DavidPivert wants to merge 2 commits into
Conversation
|
|
All contributors have signed the CLA ✍️ ✅ |
@emdash-cms/admin
@emdash-cms/auth
@emdash-cms/auth-atproto
@emdash-cms/blocks
@emdash-cms/cloudflare
@emdash-cms/contentful-to-portable-text
emdash
create-emdash
@emdash-cms/gutenberg-to-portable-text
@emdash-cms/plugin-cli
@emdash-cms/plugin-types
@emdash-cms/registry-client
@emdash-cms/registry-lexicons
@emdash-cms/sandbox-workerd
@emdash-cms/x402
@emdash-cms/plugin-ai-moderation
@emdash-cms/plugin-atproto
@emdash-cms/plugin-audit-log
@emdash-cms/plugin-color
@emdash-cms/plugin-embeds
@emdash-cms/plugin-field-kit
@emdash-cms/plugin-forms
@emdash-cms/plugin-webhook-notifier
commit: |
|
I have read the CLA Document and I hereby sign the CLA |
|
recheck |
|
Heads-up for a maintainer on the red checks — none are caused by this PR:
As a fork contributor I can't re-run Actions — happy for a maintainer to re-run the E2E shard whenever convenient. Thanks! |
What does this PR do?
Adds a prominent gotcha + a "composing panel overrides with custom defaults" snippet to the SEO section of
skills/building-emdash-site/references/site-features.md.The admin SEO panel (SEO title, meta description, OG image, canonical, noindex) lives on
entry.data.seoand has no effect unless the page callsgetSeoMeta/getContentSeo. The current docs only demonstrate this for apostspage and never warn that hand-written<title>{entry.data.title}</title>silently bypasses the whole panel — including thenoindextoggle. This is easy to hit on real sites (no error, no warning).Changes:
## SEO Meta: add an[!IMPORTANT]callout that the panel is only honored if the page reads it, and that every content detail page must wire it.getSeoMetaonly falls back todata.title/data.excerpt, show how to usegetContentSeoto let the panel take precedence over a page's computed title/description.Docs-only. The same skill is vendored under
templates/*/.agents/skills/...; left to whatever sync process keeps them in step withskills/— happy to update those too if maintained by hand.Refs #1518
Type of change
Checklist
pnpm typecheckpasses — N/A (docs-only, no code changed); CI Typecheck is greenpnpm lintpasses — N/A (docs-only)pnpm testpasses (or targeted tests for my change) — N/A (docs-only)pnpm formathas been run — N/A (markdown only)AI-generated code disclosure
Screenshots / test output
N/A — documentation change. See #1518 for the motivating real-world case.