feat(seo): default docs Article author + datePublished (E-E-A-T/freshness)#888
Open
nehagup wants to merge 1 commit into
Open
feat(seo): default docs Article author + datePublished (E-E-A-T/freshness)#888nehagup wants to merge 1 commit into
nehagup wants to merge 1 commit into
Conversation
…eshness Live-site audit found docs Article schema dropping `author` and `datePublished` on pages whose front matter omits them (e.g. /docs/server/install/, /docs/running-keploy/api-test-generator/), weakening E-E-A-T and freshness signals for AI answer engines. - author: default to the Keploy Organization when no front-matter author, so Article schema always carries an author instead of omitting it. - datePublished: fall back to the doc's last-modified time when front matter omits `date`, so every doc carries a publication/freshness signal. Both are additive fallbacks in the swizzled DocItem; pages that already set front-matter author/date are unaffected. Not touched by the open seo/audit-fixes PR. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Signed-off-by: Neha Gupta <gneha21@yahoo.in>
Contributor
There was a problem hiding this comment.
Pull request overview
This PR strengthens the JSON-LD Article (and related) schema emitted by the docs theme so that pages without front matter author/date still include an author and datePublished, improving E‑E‑A‑T and freshness signals for SEO.
Changes:
- Add
datePublishedfallback tolastUpdatedAt/lastUpdatedAt-derivedmodifiedTimewhen front matter omits a publish date. - Default
authorto a KeployOrganizationobject when no front matter author(s) are provided. - Minor Prettier-only formatting changes (regex formatting and one footer link tag).
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
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
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 & why
A live-site JSON-LD audit found docs
Articleschema droppingauthoranddatePublishedon pages whose front matter omits them (e.g./docs/server/install/,/docs/running-keploy/api-test-generator/). Missing author + publish date weaken E-E-A-T and freshness signals that AI answer engines use.Change (
src/theme/DocItem/index.js, additive fallbacks)author: default to the KeployOrganizationwhen a doc has no front-matter author (docs are authored by Keploy) — schema always carries an author instead of omitting the field.datePublished: fall back to the doc's last-modified time when front matter omitsdate, so every doc carries a publication/freshness signal.Pages that already set front-matter
author/dateare unaffected.Scope / safety
DocItem/index.jsis not touched by the openseo/audit-fixesPR — no conflict.prettier --checkpasses); deploy-preview CI will validate the build.🤖 Generated with Claude Code