feat(seo): smarter meta-description fallbacks; trim over-long defaults (2.12.1, #1142/#1324)#1333
Merged
Merged
Conversation
#1142, #1324) OG/social inspectors flagged the generic 187-char description on pages that fell back to the lab boilerplate (home + projects without a one-line summary). Give those pages distinct, length-bounded descriptions: - Home: a concise (~135 char) description mirroring the hero "About Us" blurb next to the animated logo, instead of the shared generic one. Reused for the Organization JSON-LD description too. - Projects without a `summary`: fall back to the project's `about` text (stripped + truncated to 160) rather than the generic boilerplate — gives each summary-less project a distinct description (directly helps #1142's duplicate-content signal). - Trim the last-resort generic default to ~135 chars. Per-page descriptions for listing/member pages were already fine (144-160). The image-headline / call-to-action warnings from opengraph.xyz are marketing heuristics (text baked into the share image) and intentionally not addressed — inappropriate for an academic lab and not a correctness/SEO issue. Bumps version to 2.12.1. Template/view-only — no schema change, so no migration. Adds DescriptionFallbackTests; full suite 270 green. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
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
1 participant
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.
Follow-up to the 2.12.0 SEO work, addressing the one actionable warning from
opengraph.xyz (over-long / generic descriptions on fallback pages). Verified live:
/projects/(144),/people/(145),/member/jonfroehlich/(160) were alreadyfine; only the 187-char generic fallback (home + summary-less projects like
/project/sidewalk/) was flagged.Changes
blurb next to the animated logo (instead of the shared generic boilerplate). Reused
for the Organization JSON-LD
description.summaryfall back to the project'sabouttext(stripped + truncated to 160) — so each summary-less project gets a distinct
description rather than identical boilerplate (directly reduces the duplicate-content
signal behind Google not indexing the Makeability Lab website #1142).
Intentionally NOT changed
opengraph.xyz's "missing headline in image" / "missing CTA in image" warnings are
engagement-marketing heuristics (text/CTA baked into the share-image pixels). That's
inappropriate for an academic research lab and isn't a correctness or SEO issue; the
og:imageitself is valid (1200×630, alt text, https).Testing
DescriptionFallbackTests: home uses the distinct hero description (≤160, not thegeneric); summary-less project uses About; summary+about-less project uses the
trimmed default (≤160).
🤖 Generated with Claude Code