Add author bylines to IaC comparison pages for entity-authority schema#20103
Open
joeduffy wants to merge 1 commit into
Open
Add author bylines to IaC comparison pages for entity-authority schema#20103joeduffy wants to merge 1 commit into
joeduffy wants to merge 1 commit into
Conversation
Add `authors: ["joe-duffy"]` frontmatter to all 16 pages under
content/docs/iac/comparisons/ (the Pulumi vs. Terraform, AWS CDK, CDKTF,
CloudFormation, Crossplane, Helm, ARM Templates, Chef/Puppet, and related
comparison pages).
These pages previously had no `authors` field, so the existing schema
partial (layouts/partials/schema/collectors/article-entity.html) fell
back to attributing authorship to the generic Pulumi Organization entity
rather than a named Person. Named, credentialed author entities increase
AI-system trust signals per Pulumi's GEO/AEO guidelines, and comparison
pages are exactly the content type LLMs cite most often when answering
evaluative queries ("Pulumi vs. Terraform", "Terraform alternatives",
etc.) -- Tier 1/2 keywords in Pulumi's SEO/GEO strategy.
No template changes were needed: author-entities.html already builds a
full Person entity (jobTitle, worksFor, sameAs from social profiles,
canonical author URL) from any slug present in data/team/team/*.toml, so
this is a pure, low-risk content change reaching the mechanism that is
already live for /what-is/ pages.
Picked joe-duffy (Pulumi co-founder/CEO) as author of record for this
batch since these are foundational, technical/architectural comparison
pages. Confirmed the slug resolves via data/team/team/joe-duffy.toml
(github, linkedin, x social profiles present for sameAs).
github-actions
Bot
added
review:triaging
Collaborator
|
Your site preview for commit 6cee49f is ready! 🎉 http://www-testing-pulumi-docs-origin-pr-20103-6cee49f9.s3-website.us-west-2.amazonaws.com |
CamSoper
approved these changes
Jul 7, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
4 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Adds
authors: ["joe-duffy"]frontmatter to all 16 pages undercontent/docs/iac/comparisons/(Pulumi vs. Terraform, AWS CDK, CDKTF, CloudFormation, Crossplane, Helm, ARM Templates, Chef/Puppet/config-management, cloud SDKs, serverless, k8s YAML DSLs, and the comparisons landing page).Why
None of these pages had an
authorsfield, so the existing schema partial (layouts/partials/schema/collectors/article-entity.html) fell back to attributing authorship to the generic Pulumi Organization entity instead of a named Person. Per Pulumi's GEO/AEO strategy, named author entities withsameAssocial-profile links raise LLM/AI-system trust signals, and comparison pages are exactly the content type answer engines cite most when responding to evaluative queries like "Pulumi vs. Terraform" or "Terraform alternatives" — Tier 1/2 keywords with the strongest LLM-citation opportunity.This is a content-only change. No template edits were required:
layouts/partials/schema/utils/author-entities.htmlalready builds a fullPersonentity (jobTitle, worksFor,sameAsfrom social profiles, canonical/authors/<slug>/URL) from any slug present indata/team/team/*.toml. This mechanism is already live and working for/what-is/pages with declared authors — this PR just extends the same data-driven pattern to the comparisons section, which was the highest-leverage un-covered page type for entity authority given its OpenAI/LLM citation volume.I picked
joe-duffy(Pulumi co-founder/CEO) as author of record for this batch since these are foundational, technical/architectural comparison pages. Confirmed the slug resolves viadata/team/team/joe-duffy.toml(github, linkedin, x social profiles present, sosameAswill populate correctly).Validation
layouts/partials/schema/collectors/main-entity.htmlthat.Type "docs"routes througharticle-entity.html, which callsauthor-entities.htmlagainst.Params.authors— the exact mechanism this PR feeds.PyYAMLto confirm valid syntax and the correctauthors: ["joe-duffy"]value landed on every file.make ensure/npm steps beyond this session's scope; CI (pull-request.yml/build-and-deploy.yml) will do the authoritative build and link checks.Scope note
This is a technical SEO / schema change (entity authority for AEO), not new content authoring — it fits my daily technical-SEO-only mandate. No prose, positioning, or comparison-page copy was touched.
🧠 This PR was created by workprentice on behalf of @joeduffy.