Skip to content

Rewrite release-notes landing-page descriptions (next trees)#2708

Open
ctauchen wants to merge 2 commits intotigera:mainfrom
ctauchen:descriptions-release-notes
Open

Rewrite release-notes landing-page descriptions (next trees)#2708
ctauchen wants to merge 2 commits intotigera:mainfrom
ctauchen:descriptions-release-notes

Conversation

@ctauchen
Copy link
Copy Markdown
Collaborator

@ctauchen ctauchen commented May 8, 2026

Summary

Rewrites the meta description on the three release-notes index/landing pages so they:

  • Name the canonical product (Calico Open Source / Calico Enterprise / Calico Cloud)
  • Lead with the action a user takes on the page (find what changed in each release)
  • Stay under 200 characters, no colons, no forbidden words, unique across products

Scope is intentionally narrow — only these 3 landing pages, one per product. Per-version archive pages are not touched.

Next-only on purpose — versioned-snapshot mirrors will follow after review, matching the pattern from #2696 and #2697.

Pre-fix vs post-fix

calico/release-notes/index.mdx

  • before: Release notes for Calico Open Source
  • after: Find what changed in each release of Calico Open Source, including new features, enhancements, bug fixes, deprecations, and known issues across versions.

calico-enterprise/release-notes/index.mdx

  • before: What's new, and why features provide value for upgrading.
  • after: Find what changed in each release of Calico Enterprise, with new features, enhancements, technology previews, deprecations, and bug fixes per version.

calico-cloud/release-notes/index.mdx

  • before: What's new, and why features provide value for upgrading.
  • after: Find what changed in each release of Calico Cloud, including new features, web console updates, enhancements, and fixes across dated releases.

Test plan

  • All three descriptions ≤ 200 characters
  • No colons in description values
  • No forbidden words (enable, disable, teaching)
  • Each names its canonical product exactly once
  • No cross-product duplicate strings
  • Vale clean on line 2 (description) for all three changed files

🤖 Generated with Claude Code

Copilot AI review requested due to automatic review settings May 8, 2026 15:48
@ctauchen ctauchen requested a review from a team as a code owner May 8, 2026 15:48
@netlify
Copy link
Copy Markdown

netlify Bot commented May 8, 2026

Deploy Preview succeeded!

Built without sensitive environment variables

Name Link
🔨 Latest commit 48d6f7d
🔍 Latest deploy log https://app.netlify.com/projects/tigera/deploys/69feeec6b01d5500096ebc8d
😎 Deploy Preview https://deploy-preview-2708--tigera.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 67 (🔴 down 23 from production)
Accessibility: 98 (no change from production)
Best Practices: 83 (no change from production)
SEO: 100 (no change from production)
PWA: -
View the detailed breakdown and full score reports

To edit notification comments on pull requests, go to your Netlify project configuration.

@netlify
Copy link
Copy Markdown

netlify Bot commented May 8, 2026

Deploy Preview for calico-docs-preview-next ready!

Name Link
🔨 Latest commit 48d6f7d
🔍 Latest deploy log https://app.netlify.com/projects/calico-docs-preview-next/deploys/69feeec62824790008d7a259
😎 Deploy Preview https://deploy-preview-2708--calico-docs-preview-next.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the description frontmatter on the three unversioned (“next”) release-notes pages so the metadata is product-specific and action-led.

Changes:

  • Rewrites the meta description for Calico Open Source release notes.
  • Rewrites the meta description for Calico Enterprise release notes.
  • Rewrites the meta description for Calico Cloud release notes.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

File Description
calico/release-notes/index.mdx Updates the frontmatter description for the OSS release notes page.
calico-enterprise/release-notes/index.mdx Updates the frontmatter description for the Enterprise release notes page.
calico-cloud/release-notes/index.mdx Updates the frontmatter description for the Cloud release notes landing page.

Comment thread calico/release-notes/index.mdx Outdated
@@ -1,5 +1,5 @@
---
description: Release notes for Calico Open Source
description: Find what changed in each release of Calico Open Source, including new features, enhancements, bug fixes, deprecations, and known issues across versions.
@@ -1,5 +1,5 @@
---
description: What's new, and why features provide value for upgrading.
description: Find what changed in each release of Calico Enterprise, with new features, enhancements, technology previews, deprecations, and bug fixes per version.
ctauchen and others added 2 commits May 8, 2026 18:22
Update the three release-notes index pages to use action-led
descriptions that name the canonical product and signal that the
page lists per-version release notes.

Next-only on purpose; versioned-snapshot mirrors will follow after
review.
Copilot pointed out (PR tigera#2708) that the OSS and CE release-notes index
pages are single-release pages — H1 is "Calico Open Source 3.30 release
notes" / "Calico Enterprise X.Y release notes" with one Release details
section — not multi-release archives. Reframed both to "Release notes
for the current Calico {Open Source,Enterprise} release — ...".

Calico Cloud genuinely is a multi-release index with dated entries, so
that description is unchanged.

Mirrored all three logical descriptions to their versioned snapshots:
- calico_versioned_docs/version-3.32/release-notes/index.mdx
- calico-enterprise_versioned_docs/version-3.23-1/release-notes/index.mdx
- calico-enterprise_versioned_docs/version-3.22-2/release-notes/index.mdx
- calico-cloud_versioned_docs/version-22-2/release-notes/index.mdx

7 files changed total (3 next + 4 versioned). All four content checks
clean; Vale clean on description lines.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@ctauchen ctauchen force-pushed the descriptions-release-notes branch from a039f21 to 48d6f7d Compare May 9, 2026 08:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants