Skip to content

Rework releases landing page into an overview#22873

Merged
jhlodin merged 9 commits intomainfrom
jl/doc-16115
Mar 13, 2026
Merged

Rework releases landing page into an overview#22873
jhlodin merged 9 commits intomainfrom
jl/doc-16115

Conversation

@jhlodin
Copy link
Contributor

@jhlodin jhlodin commented Feb 26, 2026

https://cockroachlabs.atlassian.net/browse/DOC-16115
https://cockroachlabs.atlassian.net/browse/DOC-16116

  • Rewrite conceptual content to be more "overview-friendly", easier to get introductory concepts
  • Remove "downloads" dynamic content which is all duplicative with downloads available on individual release pages
  • Add links directly to release pages from the releases table so it's easier to get to a specific release
  • Fix issue where "latest production release" and "its major version" weren't aligned when generated
  • Add version number dynamically to "Latest production release" and "Latest dev release" nav entries. May decide not to keep this.
  • Update (un)supported cloud versions

TODO on this page, not in scope for this PR:

  • Consolidate tables of releases in this page (and cloud releases page) into single table of all releases

@netlify
Copy link

netlify bot commented Feb 26, 2026

Deploy Preview for cockroachdb-interactivetutorials-docs canceled.

Name Link
🔨 Latest commit 73623fd
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-interactivetutorials-docs/deploys/69b432c12ee70b000859ff60

@netlify
Copy link

netlify bot commented Feb 26, 2026

Deploy Preview for cockroachdb-api-docs canceled.

Name Link
🔨 Latest commit 73623fd
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-api-docs/deploys/69b432c15d3526000803c438

@github-actions
Copy link

github-actions bot commented Feb 26, 2026

Files changed:

@netlify
Copy link

netlify bot commented Feb 26, 2026

Netlify Preview

Name Link
🔨 Latest commit 73623fd
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-docs/deploys/69b432c191cfa900083a2ff1
😎 Deploy Preview https://deploy-preview-22873--cockroachdb-docs.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.

@taroface taroface self-requested a review March 2, 2026 21:39
Copy link
Contributor

@taroface taroface left a comment

Choose a reason for hiding this comment

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

This is a nice improvement already. Blocking mainly for:

  1. code is being used instead of core in the liquid var, causing it to render as empty. I found two instances but there may be others.

  2. The discussion of "major" and "patch" versions gets confusing in a number of places, for reasons that predate this PR. I feel it's necessary to clarify those points, as it stands.

@jhlodin jhlodin requested a review from taroface March 12, 2026 19:20
For details on how LTS impacts support in CockroachDB {{ site.data.products.core }}, refer to [Release Support Policy]({% link releases/release-support-policy.md %}). For details on support per release type in CockroachDB Cloud, refer to [CockroachDB Cloud Support and Upgrade Policy]({% link cockroachcloud/upgrade-policy.md %}).

As of 2024, every second major version is an **Innovation release**. For CockroachDB {{ site.data.products.core }}, CockroachDB {{ site.data.products.standard }}, and CockroachDB {{ site.data.products.advanced }}, these releases offer shorter support windows and can be skipped. Innovation releases are required for CockroachDB {{ site.data.products.basic }}.
### Patch releases
Copy link
Contributor

Choose a reason for hiding this comment

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

This section is much much better than what was there before, kudos

Copy link
Contributor

@taroface taroface left a comment

Choose a reason for hiding this comment

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

Looks great! Thanks for the clean rewrites.

@jhlodin jhlodin merged commit 75f71d1 into main Mar 13, 2026
6 checks passed
@jhlodin jhlodin deleted the jl/doc-16115 branch March 13, 2026 18:07
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