SEO: Give release notes pages product-specific titles#2858
Open
ctauchen wants to merge 1 commit into
Open
Conversation
The release notes pages across all products used the generic frontmatter `title: Release notes`, producing a `<title>Release notes | Calico Documentation</title>` that omits the product name — weakening the exact-match signal for queries like "Calico release notes". Set product-specific titles (Calico Open Source / Calico Enterprise / Calico Cloud release notes) across the current and versioned docs for all three products, plus the Calico Enterprise release-notes template so future pages inherit it. Added `sidebar_label: Release notes` on each so the navigation label is unchanged. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
✅ Deploy Preview for calico-docs-preview-next ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
❌ Deploy Preview for tigera failed. Why did it fail? →Built without sensitive environment variables
|
Contributor
There was a problem hiding this comment.
Pull request overview
Updates release-notes doc frontmatter across Calico Open Source, Calico Enterprise, and Calico Cloud (including versioned docs) to use product-specific page titles for stronger SEO signals, while keeping sidebar/navigation labels stable.
Changes:
- Set product-specific
titlefrontmatter for release notes pages across current + versioned docs. - Add
sidebar_label: Release notesso sidebar labels remain unchanged. - Update the Calico Enterprise release-notes
_template.mdxso newly cut pages inherit the new title.
Reviewed changes
Copilot reviewed 13 out of 13 changed files in this pull request and generated 4 comments.
Show a summary per file
| File | Description |
|---|---|
| calico/release-notes/index.mdx | Set Calico OSS-specific title and add sidebar_label to preserve nav label. |
| calico_versioned_docs/version-3.32/release-notes/index.mdx | Set Calico OSS-specific title and add sidebar_label for the 3.32 docs. |
| calico_versioned_docs/version-3.31/release-notes/index.mdx | Set Calico OSS-specific title and add sidebar_label for the 3.31 docs. |
| calico_versioned_docs/version-3.30/release-notes/index.mdx | Set Calico OSS-specific title and add sidebar_label for the 3.30 docs. |
| calico_versioned_docs/version-3.29/release-notes/index.mdx | Set Calico OSS-specific title and add sidebar_label for the 3.29 docs. |
| calico-enterprise/release-notes/index.mdx | Set Enterprise-specific title and add sidebar_label to preserve nav label. |
| calico-enterprise/release-notes/_template.mdx | Update Enterprise release-notes template to emit the new title + sidebar_label in future cuts. |
| calico-enterprise_versioned_docs/version-3.23-2/release-notes/index.mdx | Set Enterprise-specific title and add sidebar_label for the 3.23 docs. |
| calico-enterprise_versioned_docs/version-3.22-2/release-notes/index.mdx | Set Enterprise-specific title and add sidebar_label for the 3.22 docs. |
| calico-enterprise_versioned_docs/version-3.21-2/release-notes/index.mdx | Set Enterprise-specific title and add sidebar_label for the 3.21 docs. |
| calico-enterprise_versioned_docs/version-3.20-2/release-notes/index.mdx | Set Enterprise-specific title and add sidebar_label for the 3.20 docs. |
| calico-cloud/release-notes/index.mdx | Set Cloud-specific title and add sidebar_label to preserve nav label. |
| calico-cloud_versioned_docs/version-22-2/release-notes/index.mdx | Set Cloud-specific title and add sidebar_label for the 22-2 docs. |
| @@ -1,6 +1,7 @@ | |||
| --- | |||
| description: Release notes for the current Calico Open Source release — new features, enhancements, technology previews, deprecations, bug fixes, and known issues. | |||
| @@ -1,6 +1,7 @@ | |||
| --- | |||
| description: Release notes for the current Calico Enterprise release — new features, enhancements, technology previews, deprecations, upgrade notes, and bug fixes. | |||
| @@ -1,6 +1,7 @@ | |||
| --- | |||
| description: Release notes for the current Calico Enterprise release — new features, enhancements, technology previews, deprecations, and bug fixes. | |||
| @@ -1,6 +1,7 @@ | |||
| --- | |||
| description: Release notes for the current Calico Enterprise release — new features, enhancements, technology previews, deprecations, upgrade notes, and bug fixes. | |||
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.
Problem
Every product's release notes page uses the generic frontmatter
title: Release notes, which renders as:The product name is missing from the
<title>tag — the element search engines weight most heavily — so the page has a weak exact-match signal for high-intent queries like "Calico release notes". (In the field, the release notes page is being out-ranked by less relevant pages such as Component versions.)Change
Set product-specific
titlefrontmatter across the current + all versioned docs for each product:titleCalico Open Source release notesCalico Enterprise release notesCalico Cloud release notesThe title is intentionally version-less (not "3.32"), so the
<title>stays stable across releases instead of churning every cut.Also added
sidebar_label: Release notesto each page so the sidebar/navigation label is unchanged (the Calico OSS sidebar derives its label fromtitle). The Calico Enterprise release-notes_template.mdxis updated too, so future cut pages inherit the correct title.Notes
# H1headings (e.g. "Calico Open Source 3.32 release notes") are untouched.🤖 Generated with Claude Code