From f266a0430d66f177d8a90355ce1aa63cca73d158 Mon Sep 17 00:00:00 2001 From: Vanshika Date: Sun, 12 Jul 2026 19:14:38 +0530 Subject: [PATCH 1/5] docs: add missing meta description tag to site head 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 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 --- docs/layouts/partials/head.html | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/layouts/partials/head.html b/docs/layouts/partials/head.html index a33a25a0ec..e87307b4ad 100644 --- a/docs/layouts/partials/head.html +++ b/docs/layouts/partials/head.html @@ -11,6 +11,12 @@ {{ end -}} {{ partialCached "favicons.html" . }} {{ if .IsHome }}{{ .Site.Title }}{{ else }}{{ with .Title }}{{ . }} | {{ end }}{{ .Site.Title }}{{ end }} + +{{ $description := .Page.Description }} +{{ if not $description }}{{ $description = .Page.Summary | plainify | truncate 150 }}{{ end }} +{{ if $description }} + +{{ end }} {{- template "_internal/opengraph.html" . -}} {{- template "_internal/schema.html" . -}} {{- template "_internal/twitter_cards.html" . -}} From 132baee4178a8addfde62896d6d8836f2f822c1c Mon Sep 17 00:00:00 2001 From: Vanshika Date: Sun, 12 Jul 2026 19:14:52 +0530 Subject: [PATCH 2/5] docs: give homepage a meaningful description and h1 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

: its main tagline is a plain

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

to

. 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 --- docs/assets/scss/_styles_project.scss | 1 + docs/content/en/_index.html | 5 +++-- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/assets/scss/_styles_project.scss b/docs/assets/scss/_styles_project.scss index 00a7680e9c..bcbc4d7734 100644 --- a/docs/assets/scss/_styles_project.scss +++ b/docs/assets/scss/_styles_project.scss @@ -19,6 +19,7 @@ .headline { font-size: 1.5rem; font-weight: 600; + line-height: 1.5; margin-bottom: 25px; } diff --git a/docs/content/en/_index.html b/docs/content/en/_index.html index 065e98c006..4932bca61f 100644 --- a/docs/content/en/_index.html +++ b/docs/content/en/_index.html @@ -1,14 +1,15 @@ +++ title = "PipeCD" linkTitle = "PipeCD" +description = "PipeCD is a GitOps style continuous delivery platform that provides a consistent deployment and operations experience for Kubernetes, Terraform, Cloud Run, AWS Lambda, Amazon ECS, and more." +++ {{< blocks/cover height="med" image_anchor="top" color="primary" >}}
-

+

The One CD for All {applications, platforms, operations} -

+

A GitOps style continuous delivery platform that provides
consistent deployment and operations experience for any application.

From 4d84924ab855449872d3059414f7ba49ff12fe62 Mon Sep 17 00:00:00 2001 From: Vanshika Date: Sun, 12 Jul 2026 19:15:06 +0530 Subject: [PATCH 3/5] docs: add alt text to homepage core value images 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 --- docs/layouts/shortcodes/blocks/value.html | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/layouts/shortcodes/blocks/value.html b/docs/layouts/shortcodes/blocks/value.html index 2bb8512672..58fd33f72a 100644 --- a/docs/layouts/shortcodes/blocks/value.html +++ b/docs/layouts/shortcodes/blocks/value.html @@ -1,5 +1,6 @@ {{ $_hugo_config := `{ "version": 1 }` }} {{ $value_image := resources.GetMatch (printf "**%s*" .Params.image) }} +{{ $value_title := .Params.title }}
@@ -19,6 +20,7 @@ {{ $image_resized_750.RelPermalink }} 1.5x, {{ $image_resized_1000.RelPermalink }} 2x, {{ $image_resized_1500.RelPermalink }} 3x" + alt="{{ $value_title }}" data-zoom-src="{{ $image_resized_zoom.RelPermalink }}" data-zoomable /> From 653eb981abe43e1d3ce16890b209035ca9ef70a5 Mon Sep 17 00:00:00 2001 From: Vanshika Date: Sun, 12 Jul 2026 19:15:20 +0530 Subject: [PATCH 4/5] docs: add explicit height to footer CNCF logo 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 --- docs/layouts/partials/footer.html | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/layouts/partials/footer.html b/docs/layouts/partials/footer.html index 76c55fe4aa..ade6428dfc 100644 --- a/docs/layouts/partials/footer.html +++ b/docs/layouts/partials/footer.html @@ -4,13 +4,14 @@ {{ $text_color := "text-white" }} {{ if .IsHome }} {{ $text_color = "text-dark" }} {{ end }} {{ $cncf_logo := "https://www.cncf.io/wp-content/uploads/2022/05/CNCF_logo_white.svg" }} -{{ if .IsHome }} {{ $cncf_logo = "https://www.cncf.io/wp-content/uploads/2022/07/cncf-color-bg.svg" }} {{ end }} +{{ $cncf_logo_height := "40" }} +{{ if .IsHome }} {{ $cncf_logo = "https://www.cncf.io/wp-content/uploads/2022/07/cncf-color-bg.svg" }} {{ $cncf_logo_height = "48" }} {{ end }}
- cncf logo + cncf logo
PipeCD is a Cloud Native Computing Foundation sandbox project.
From 578c803547a9b657ea4a8c482e103082f50ad290 Mon Sep 17 00:00:00 2001 From: Vanshika Date: Fri, 24 Jul 2026 08:29:16 +0530 Subject: [PATCH 5/5] docs: preserve aspect ratio on footer CNCF logo Review feedback on the previous width/height fix pointed out that the img has no height:auto CSS, so a mismatch between the fixed width/height attributes and the logo's intrinsic ratio could distort it, and asked for confirmation this isn't happening. The homepage variant's height attribute (48) is a rounded value: the CNCF color logo's real intrinsic ratio yields ~47.65 for a 250-wide box, a ~0.7% difference. Rendering showed no visible distortion, because both logo files are SVGs with a viewBox and no preserveAspectRatio override, so the default "xMidYMid meet" behavior scales them uniformly within the box instead of stretching them like a raster image. Confirmed by inspecting the built site: the swoosh mark renders as a perfect square in both before/after screenshots. Add height: auto so the browser derives the rendered height from the image's real aspect ratio instead of the rounded attribute, removing that small mismatch outright. This keeps the CLS benefit of the previous fix: browsers compute a default aspect-ratio from the width/height attributes even when height:auto is set, so layout space is still reserved before the image loads. Signed-off-by: Vanshika --- docs/layouts/partials/footer.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/layouts/partials/footer.html b/docs/layouts/partials/footer.html index f8d1e87d2f..e55f0cc6e8 100644 --- a/docs/layouts/partials/footer.html +++ b/docs/layouts/partials/footer.html @@ -11,7 +11,7 @@
- cncf logo + cncf logo
PipeCD is a Cloud Native Computing Foundation sandbox project.