Skip to content

docs(blog): enable FAQPage schema on 14 blog posts with qualifying Q&A headers#20522

Open
workprentice[bot] wants to merge 1 commit into
masterfrom
seo/faq-schema-blog-batch-3
Open

docs(blog): enable FAQPage schema on 14 blog posts with qualifying Q&A headers#20522
workprentice[bot] wants to merge 1 commit into
masterfrom
seo/faq-schema-blog-batch-3

Conversation

@workprentice

@workprentice workprentice Bot commented Jul 25, 2026

Copy link
Copy Markdown
Contributor

Summary

Enables FAQPage structured data (JSON-LD) on 14 blog posts that already contain genuine question-form H2/H3 sections but were missing the faq_schema: true front-matter flag required by layouts/partials/schema/collectors/faq-entity.html.

Why

Per Pulumi's SEO/AEO strategy, FAQPage schema is the highest-leverage lever for both traditional rich-result eligibility and AI answer-engine citation (GEO) — content that isn't structured for extraction gets skipped by LLM chunking. These 14 posts already have qualifying Q&A content (5–25 question-form headers each) and simply weren't opted into schema emission. This follows the same pattern shipped on prior comparison/guide pages (PR #20499).

Files changed (14, +1 line each, front matter only)

  • content/blog/announcing-per-user-pricing-and-unlimited-stacks-for-teams/index.md (6 question headers)
  • content/blog/aws-lambda-container-support/index.md (7)
  • content/blog/azure-container-solutions/index.md (6)
  • content/blog/backstage-vs-pulumi-idp-why-infrastructure-first-platform-engineering-matters/index.md (5)
  • content/blog/developer-experience-business-critical/index.md (9)
  • content/blog/embrace-kubernetes-part1/index.md (6)
  • content/blog/fast-docker-image-builds-with-pulumi/index.md (7)
  • content/blog/generative-ai-apps-devops-talks-pulumi-user-group/index.md (6)
  • content/blog/helm-release-resource-for-kubernetes-generally-available/index.md (5)
  • content/blog/kubernetes-best-practices-i-wish-i-had-known-before/index.md (25)
  • content/blog/run-deepseek-on-aws-ec2-using-pulumi/index.md (7)
  • content/blog/serverless-api/index.md (7)
  • content/blog/the-guide-platform-engineering-idp-steps-best-practices/index.md (8)
  • content/blog/why-switch-to-pulumi/index.md (6)

Verification

  • Confirmed the schema gate by reading layouts/partials/schema/collectors/faq-entity.html directly (front-matter field is faq_schema: true; the unrelated schema_type field is not read by this collector).
  • Grepped each file for genuine question-form ##/### headers before adding the flag — every file has at least 5 qualifying headers.
  • Re-validated all 14 front-matter blocks parse as valid YAML with faq_schema: true set and no other content altered.
  • git diff --stat confirms exactly 14 files changed, +1 line each — no unintended content changes.
  • No local Hugo build available in this environment; deferring full-site build validation to CI's "Install deps and build site" gate.

#new-review

@claude please review


🧠 This PR was created by workprentice via automated technical-SEO agent on behalf of the Pulumi marketing/growth workspace.

…A headers

These posts already contain genuine question-form H2/H3 sections (5-25 each)
but were missing the faq_schema: true front-matter flag required by
layouts/partials/schema/collectors/faq-entity.html to emit FAQPage JSON-LD.

Enabling FAQPage schema on these pages supports both traditional rich-result
eligibility and AI answer-engine citation (GEO), consistent with the pattern
already shipped on prior comparison/guide pages this week.
@github-actions github-actions Bot added review:triaging Claude Triage is currently classifying the PR review:frontmatter-only Frontmatter-only PR (any size); skips Claude review like review:trivial does domain:blog PR touches blog posts or customer stories and removed review:triaging Claude Triage is currently classifying the PR labels Jul 25, 2026
@workprentice

workprentice Bot commented Jul 25, 2026

Copy link
Copy Markdown
Contributor Author

@claude #new-review

@workprentice

workprentice Bot commented Jul 26, 2026

Copy link
Copy Markdown
Contributor Author

@claude #new-review

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

domain:blog PR touches blog posts or customer stories review:frontmatter-only Frontmatter-only PR (any size); skips Claude review like review:trivial does

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants