Topic website seo lighthouse#7020
Open
vanshika2720 wants to merge 4 commits into
Open
Conversation
Lighthouse's SEO audit flags every page on pipecd.dev for lacking a meta description, since the project's override of the Docsy head partial never included one. Emit <meta name="description"> using the page's own description front matter when set, falling back to a truncated page summary otherwise. The tag is only rendered when a non-empty value is available, so pages with no body content are left unchanged rather than shipping an empty description. Signed-off-by: Vanshika <pahalvanshikaa@gmail.com>
The homepage has no explicit description, so it falls back to a truncated dump of its shortcode-rendered body text, which reads as a run-on sentence and is a poor meta/OG description for search and social previews. The homepage also has no <h1>: its main tagline is a plain <p> styled to look like a heading, so the page lacks a top-level heading entirely. This trips Lighthouse's SEO and accessibility heading-order checks and leaves screen reader users without a page landmark. Add a hand-written description front-matter field, and change the tagline element from <p> to <h1>. Add line-height: 1.5 to the .headline rule so the heading renders identically to the previous paragraph (browser default heading line-height differs from body text). Signed-off-by: Vanshika <pahalvanshikaa@gmail.com>
The four core-value images on the homepage (multi-provider, secure, automation, visibility) render without an alt attribute, so screen readers cannot describe them and Lighthouse's accessibility audit flags them as images without alt text. Use each value block's own title as the image's alt text, since it already describes what the image represents. Capture the title in a variable before entering the "with $value_image" block, since "." is rebound to the image resource inside that block and no longer exposes .Params. Signed-off-by: Vanshika <pahalvanshikaa@gmail.com>
The CNCF logo in the footer sets width="250" but no height, which Lighthouse's performance audit flags as missing explicit image dimensions, since the browser cannot reserve layout space for the image before it loads and this can contribute to layout shift. Add a height attribute matching each logo variant's real aspect ratio (the color-on-white homepage logo and the white footer logo have different intrinsic proportions), so the rendered size is unchanged. Signed-off-by: Vanshika <pahalvanshikaa@gmail.com>
vanshika2720
requested review from
Warashi,
khanhtc1202,
mohammedfirdouss and
t-kikuc
July 12, 2026 13:50
Contributor
Author
|
@yashisrani please review. |
|
@vanshika2720 can you attach new lighthouse report to see the improvements ? |
Contributor
Author
|
@yashisrani @mohammedfirdouss @rahulshendre I have attached the screenshot. PTAL! |
|
@vanshika2720 Looks good to me |
This was referenced Jul 14, 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
2 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 this PR does:
This PR addresses a focused subset of the Lighthouse recommendations by improving the website's SEO and accessibility without changing its appearance or functionality.
Specifically, it:
<meta name="description">tag to the site head.<h1>while preserving its existing styling.altattributes to the homepage core value images.heightattributes to the footer CNCF logo to reduce layout shift.These changes are intentionally limited to a small, reviewable subset of the recommendations from Issue #7019.
Why we need it:
A Lighthouse audit identified several opportunities to improve the website's SEO and accessibility.
This PR addresses a number of low-risk, high-impact recommendations by:
Which issue(s) this PR fixes:
Fixes #7019
Does this PR introduce a user-facing change?:
Yes.
How are users affected by this change:
Is this breaking change:
How to migrate (if breaking change):