Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions src/current/_includes/common/upgrade/overview.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
### Types of upgrades

- **Major-version upgrades**: A [major-version upgrade]({% link releases/index.md %}#major-releases), such as from v24.2 to v24.3, may include new features, updates to cluster setting defaults, and backward-incompatible changes. Performing a major-version upgrade requires an additional step to finalize the upgrade.
- **Major-version upgrades**: A [major-version upgrade]({% link releases/index.md %}#major-versions), such as from v24.2 to v24.3, may include new features, updates to cluster setting defaults, and backward-incompatible changes. Performing a major-version upgrade requires an additional step to finalize the upgrade.
Copy link
Contributor

Choose a reason for hiding this comment

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

Optional nit: Could we use liquid vars to call out the latest and previous major release here, instead of hardcoding 24.2 and 24.3?


{% if page.path contains "cockroachcloud" %}
As of 2024, there are four major versions per year, where every second release is an [Innovation release]({% link cockroachcloud/upgrade-policy.md %}#innovation-releases). For CockroachDB {{ site.data.products.advanced }}, Innovation releases include all of the latest features but have shorter [support windows]({% link cockroachcloud/upgrade-policy.md %}#cockroachdb-cloud-support-policy) and can be skipped.
Expand All @@ -17,7 +17,7 @@
For all CockroachDB {{ site.data.products.cloud }} clusters, production patch releases for a major version are automatically applied until the cluster is upgraded to a new major version. On an {{ site.data.products.advanced }} cluster, you have the option to defer patch updates for 30, 60, or 90 days if you have a [maintenance window]({% link cockroachcloud/advanced-cluster-management.md %}#set-a-maintenance-window) configured.
{% endif %}

To learn more about CockroachDB major versions and patches, refer to the [Releases Overview]({% link releases/index.md %}#overview).
To learn more about CockroachDB major versions and patches, refer to the [Releases Overview]({% link releases/index.md %}).
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
To learn more about CockroachDB major versions and patches, refer to the [Releases Overview]({% link releases/index.md %}).
To learn more about CockroachDB major versions and patches, refer to [CockroachDB Releases Overview]({% link releases/index.md %}).


{% if page.path contains "cockroachcloud" %}
### Upgrade differences across Cloud plans
Expand Down
2 changes: 1 addition & 1 deletion src/current/_includes/releases/v23.1/v23.1.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ With the release of CockroachDB v23.1, we've added new capabilities in Cockroach

<h3 id="v23-1-0-feature-highlights">Feature highlights</h3>

This section summarizes the most significant user-facing changes in v23.1.0. For a complete list of features and changes, including bug fixes and performance improvements, see the [release notes]({% link releases/index.md %}#testing-releases) for previous testing releases. You can also search for [what's new in v23.1 in our docs](https://www.cockroachlabs.com/docs/search?query=new+in+v23.1).
This section summarizes the most significant user-facing changes in v23.1.0. For a complete list of features and changes, including bug fixes and performance improvements, see the release notes for previous testing releases. You can also search for [what's new in v23.1 in our docs](https://www.cockroachlabs.com/docs/search?query=new+in+v23.1).
Copy link
Contributor

Choose a reason for hiding this comment

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

Confused why that link was removed, given that the content behind that link is still intact. The result is that we refer verbally to "release notes for previous testing releases" without pointing to them. I understand that we eventually want to remove them, but if this is prepping us for that step, can we save it until it happens? (This comment applies to all the changes below.)


{{site.data.alerts.callout_info}}
The features highlighted below are freely available in CockroachDB {{ site.data.products.core }} and do not require an [enterprise license]({% link v23.1/cockroach-demo.md %}) to test enterprise features in a local, temporary cluster.
Expand Down
2 changes: 1 addition & 1 deletion src/current/_includes/releases/v23.2/v23.2.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ With the release of CockroachDB v23.2, we've added new capabilities to help you

<h3 id="v23-2-0-feature-highlights">Feature highlights</h3>

This section summarizes the most significant user-facing changes in v23.2.0 and other features recently made available to CockroachDB users across versions. For a complete list of features and changes in v23.2, including bug fixes and performance improvements, see the [release notes]({% link releases/index.md %}#testing-releases) for previous v23.2 testing releases. You can also search the docs for sections labeled [New in v23.2](https://www.cockroachlabs.com/docs/search?query=new+in+v23.2).
This section summarizes the most significant user-facing changes in v23.2.0 and other features recently made available to CockroachDB users across versions. For a complete list of features and changes in v23.2, including bug fixes and performance improvements, see the release notes for previous v23.2 testing releases. You can also search the docs for sections labeled [New in v23.2](https://www.cockroachlabs.com/docs/search?query=new+in+v23.2).

- **Feature categories**
- [Observability](#v23-2-0-observability)
Expand Down
2 changes: 1 addition & 1 deletion src/current/_includes/releases/v24.1/v24.1.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ With the release of CockroachDB v24.1, we've added new capabilities to help you

<h3 id="v24-1-0-feature-highlights">Feature highlights</h3>

This section summarizes the most significant user-facing changes in v24.1.0 and other features recently made available to CockroachDB users across versions. For a complete list of features and changes in v24.1, including bug fixes and performance improvements, refer to the [release notes]({% link releases/index.md %}#testing-releases) for previous v24.1 testing releases. You can also search the docs for sections labeled [New in v24.1](https://www.cockroachlabs.com/docs/search?query=new+in+v24.1).
This section summarizes the most significant user-facing changes in v24.1.0 and other features recently made available to CockroachDB users across versions. For a complete list of features and changes in v24.1, including bug fixes and performance improvements, refer to the release notes for previous v24.1 testing releases. You can also search the docs for sections labeled [New in v24.1](https://www.cockroachlabs.com/docs/search?query=new+in+v24.1).

- **Feature categories**
- [Performance](#v24-1-0-performance)
Expand Down
2 changes: 1 addition & 1 deletion src/current/_includes/releases/v24.2/v24.2.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ With the release of CockroachDB v24.2, we've added new capabilities to help you

<h3 id="v24-2-0-feature-highlights">Feature highlights</h3>

This section summarizes the most significant user-facing changes in v24.2.0 and other features recently made available to CockroachDB users across versions. For a complete list of features and changes in v24.2, including bug fixes and performance improvements, refer to the [release notes]({% link releases/index.md %}#testing-releases) for previous v24.2 testing releases. You can also search the docs for sections labeled [New in v24.2](https://www.cockroachlabs.com/docs/search?query=new+in+v24.2).
This section summarizes the most significant user-facing changes in v24.2.0 and other features recently made available to CockroachDB users across versions. For a complete list of features and changes in v24.2, including bug fixes and performance improvements, refer to the release notes for previous v24.2 testing releases. You can also search the docs for sections labeled [New in v24.2](https://www.cockroachlabs.com/docs/search?query=new+in+v24.2).

- **Feature categories**
- [Change data capture](#v24-2-0-change-data-capture)
Expand Down
2 changes: 1 addition & 1 deletion src/current/_includes/releases/v24.3/v24.3.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ With the release of CockroachDB v24.3, we've added new capabilities to help you

<h3 id="v24-3-0-feature-highlights">Feature highlights</h3>

This section summarizes the most significant user-facing changes in v24.3.0 and other features recently made available to CockroachDB users across versions. For a complete list of features and changes in v24.3, including bug fixes and performance improvements, refer to the [release notes]({% link releases/index.md %}#testing-releases) for previous v24.3 testing releases. You can also search the docs for sections labeled [New in v24.3](https://www.cockroachlabs.com/docs/search?query=new+in+v24.3).
This section summarizes the most significant user-facing changes in v24.3.0 and other features recently made available to CockroachDB users across versions. For a complete list of features and changes in v24.3, including bug fixes and performance improvements, refer to the release notes for previous v24.3 testing releases. You can also search the docs for sections labeled [New in v24.3](https://www.cockroachlabs.com/docs/search?query=new+in+v24.3).

- **Feature categories**
- [CockroachDB Licensing](#v24-3-0-licensing)
Expand Down
2 changes: 1 addition & 1 deletion src/current/_includes/releases/v25.1/v25.1.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ With the release of CockroachDB v25.1, we've added new capabilities to help you

<h3 id="v25-1-0-feature-highlights">Feature highlights</h3>

This section summarizes the most significant user-facing changes in v25.1.0 and other features recently made available to CockroachDB users across versions. For a complete list of features and changes in v25.1, including bug fixes and performance improvements, refer to the [release notes]({% link releases/index.md %}#testing-releases) for previous v25.1 testing releases. You can also search the docs for sections labeled [New in v25.1](https://www.cockroachlabs.com/docs/search?query=new+in+v25.1).
This section summarizes the most significant user-facing changes in v25.1.0 and other features recently made available to CockroachDB users across versions. For a complete list of features and changes in v25.1, including bug fixes and performance improvements, refer to the release notes for previous v25.1 testing releases. You can also search the docs for sections labeled [New in v25.1](https://www.cockroachlabs.com/docs/search?query=new+in+v25.1).

- **Feature categories**
- [CockroachDB Cloud](#v25-1-0-cloud)
Expand Down
2 changes: 1 addition & 1 deletion src/current/_includes/releases/v25.2/v25.2.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ For a summary of the most significant changes, refer to [Feature Highlights](#v2

<h3 id="v25-2-0-feature-highlights">Feature highlights</h3>

This section summarizes the most significant user-facing changes in v25.2.0 and other features recently made available to CockroachDB users across versions. For a complete list of features and changes in v25.2, including bug fixes and performance improvements, refer to the [release notes]({% link releases/index.md %}#testing-releases) for v25.2 testing releases. You can also search the docs for sections labeled [New in v25.2](https://www.cockroachlabs.com/docs/search?query=new+in+v25.2).
This section summarizes the most significant user-facing changes in v25.2.0 and other features recently made available to CockroachDB users across versions. For a complete list of features and changes in v25.2, including bug fixes and performance improvements, refer to the release notes for v25.2 testing releases. You can also search the docs for sections labeled [New in v25.2](https://www.cockroachlabs.com/docs/search?query=new+in+v25.2).

- **Feature categories**
- [CockroachDB Cloud](#v25-2-0-cloud)
Expand Down
2 changes: 1 addition & 1 deletion src/current/_includes/releases/v25.3/v25.3.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ Before [upgrading to CockroachDB v25.3]({% link v25.3/upgrade-cockroach-version.

<h3 id="v25-3-0-feature-highlights">Feature Highlights</h3>

This section summarizes the most significant user-facing changes in v25.3.0 and other features recently made available to CockroachDB users across versions. For a complete list of features and changes in v25.3, including bug fixes and performance improvements, refer to the [release notes]({% link releases/index.md %}#testing-releases) for v25.3 testing releases. You can also search the docs for sections labeled [New in v25.3](https://www.cockroachlabs.com/docs/search?query=New+in+v25.3).
This section summarizes the most significant user-facing changes in v25.3.0 and other features recently made available to CockroachDB users across versions. For a complete list of features and changes in v25.3, including bug fixes and performance improvements, refer to the release notes for v25.3 testing releases. You can also search the docs for sections labeled [New in v25.3](https://www.cockroachlabs.com/docs/search?query=New+in+v25.3).

<div id="feature-highlights">

Expand Down
2 changes: 1 addition & 1 deletion src/current/_includes/releases/v25.4/v25.4.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ Before [upgrading to CockroachDB v25.4]({% link v25.4/upgrade-cockroach-version.

<h3 id="v25-4-0-feature-highlights">Feature Highlights</h3>

This section summarizes the most significant user-facing changes in v25.4.0 and other features recently made available to CockroachDB users across versions. For a complete list of features and changes in v25.4, including bug fixes and performance improvements, refer to the [release notes]({% link releases/index.md %}#testing-releases) for v25.4 testing releases. You can also search the docs for sections labeled [New in v25.4](https://www.cockroachlabs.com/docs/search?query=New+in+v25.4).
This section summarizes the most significant user-facing changes in v25.4.0 and other features recently made available to CockroachDB users across versions. For a complete list of features and changes in v25.4, including bug fixes and performance improvements, refer to the release notes for v25.4 testing releases. You can also search the docs for sections labeled [New in v25.4](https://www.cockroachlabs.com/docs/search?query=New+in+v25.4).

<div id="feature-highlights">

Expand Down
2 changes: 1 addition & 1 deletion src/current/_includes/releases/v26.1/v26.1.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ Before [upgrading to CockroachDB v26.1]({% link v26.1/upgrade-cockroach-version.

<h3 id="v26-1-0-feature-highlights">Feature Highlights</h3>

This section summarizes the most significant user-facing changes in v26.1.0 and other features recently made available to CockroachDB users across versions. For a complete list of features and changes in v26.1, including bug fixes and performance improvements, refer to the [release notes]({% link releases/index.md %}#testing-releases) for v26.1 testing releases. You can also search the docs for sections labeled [New in v26.1](https://www.cockroachlabs.com/docs/search?query=New+in+v26.1).
This section summarizes the most significant user-facing changes in v26.1.0 and other features recently made available to CockroachDB users across versions. For a complete list of features and changes in v26.1, including bug fixes and performance improvements, refer to the release notes for v26.1 testing releases. You can also search the docs for sections labeled [New in v26.1](https://www.cockroachlabs.com/docs/search?query=New+in+v26.1).

<div id="feature-highlights">

Expand Down
2 changes: 1 addition & 1 deletion src/current/_includes/releases/whats-new-intro.md
Original file line number Diff line number Diff line change
Expand Up @@ -90,7 +90,7 @@ no_highlights: {{ no_highlights }}<br />
CockroachDB {{ page.major_version }} is in active development, and the following [testing releases]({% link releases/index.md %}#release-types) are intended for testing and experimentation only, and are not qualified for production environments or eligible for support or uptime SLA commitments. When CockroachDB {{ page.major_version }} is Generally Available (GA), production releases will also be announced on this page.
{% else %}{% comment %}Begin GA-only content{% endcomment %}
{% if skippable == true %}
CockroachDB {{ page.major_version }} is an [Innovation Release]({% link releases/release-support-policy.md %}#support-types), which is optional for CockroachDB {{ site.data.products.advanced }}, CockroachDB {{ site.data.products.standard }}, and CockroachDB {{ site.data.products.core }} clusters but is required for CockroachDB {{ site.data.products.basic }}.
CockroachDB {{ page.major_version }} is an [Innovation Release]({% link releases/release-support-policy.md %}#support-types), which is optional for CockroachDB {{ site.data.products.advanced }} and {{ site.data.products.code }}. Innovation releases including {{ page.major_version }} are unavailable for CockroachDB {{ site.data.products.standard }} and CockroachDB {{ site.data.products.basic }} clusters.
Copy link
Contributor

Choose a reason for hiding this comment

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

{{ site.data.products.code }} is coming up empty in preview.

Copy link
Contributor

Choose a reason for hiding this comment

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

I think this is a more informative link for this context:

Suggested change
CockroachDB {{ page.major_version }} is an [Innovation Release]({% link releases/release-support-policy.md %}#support-types), which is optional for CockroachDB {{ site.data.products.advanced }} and {{ site.data.products.code }}. Innovation releases including {{ page.major_version }} are unavailable for CockroachDB {{ site.data.products.standard }} and CockroachDB {{ site.data.products.basic }} clusters.
CockroachDB {{ page.major_version }} is an optional [Innovation release]({% link releases/index.md %}#major-versions). This version can be skipped for CockroachDB {{ site.data.products.advanced }} and {{ site.data.products.core }} clusters. It is unavailable for CockroachDB {{ site.data.products.standard }} and CockroachDB {{ site.data.products.basic }} clusters.

{% else %}
CockroachDB {{ page.major_version }}{% if lts == true %} [(LTS)]({% link releases/release-support-policy.md %}#support-phases){% endif %} is a required [Regular Release]({% link releases/release-support-policy.md %}#support-types).
Copy link
Contributor

Choose a reason for hiding this comment

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

Ditto

Suggested change
CockroachDB {{ page.major_version }}{% if lts == true %} [(LTS)]({% link releases/release-support-policy.md %}#support-phases){% endif %} is a required [Regular Release]({% link releases/release-support-policy.md %}#support-types).
CockroachDB {{ page.major_version }}{% if lts == true %} [(LTS)]({% link releases/release-support-policy.md %}#support-types){% endif %} is a required [Regular release]({% link releases/index.md %}#major-versions).

{% endif %}
Expand Down
24 changes: 12 additions & 12 deletions src/current/_includes/sidebar-all-releases.json
Original file line number Diff line number Diff line change
@@ -1,27 +1,27 @@
{%- assign versions = site.data.versions | where_exp: "versions", "versions.major_version != site.versions['dev']" | where_exp: "versions", "versions.major_version != site.versions['stable']" | map: "major_version" -%}
{%- comment -%} versions iterates through the list of major versions (e.g., v21.2) in _data/versions.csv and returns all releases that are not dev or stable. We then pull only the major version name instead of the whole dictionary with map: "major_version" {%- endcomment -%}
{
"title": "Latest Production Release",
"title": "Overview",
"urls": [
"/releases/index.html",
"/releases/"
{% for v in versions %}
,"/releases/{{ v }}.html"
Copy link
Contributor

Choose a reason for hiding this comment

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

As we discussed, not sure if this is causing a releases/releases.md link to be generated, but that link gives a 404 and we should eliminate it if possible.

{% endfor %}
]
},
{
"title": "Latest Production Release ({{ site.versions["stable"] }})",
"urls": [
"/releases/{{ site.versions["stable"] }}.html"
]
}{% unless site.versions["stable"] == site.versions["dev"] %},
{
"title": "Latest Testing Release",
"title": "Latest Testing Release ({{ site.versions["dev"] }})",
Copy link
Contributor

Choose a reason for hiding this comment

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

I don't see this in the preview nav - is that expected?

Image

"urls": [
"/releases/{{ site.versions["dev"] }}.html"
]
}{% endunless %},
{
"title": "CockroachDB Releases",
"urls": [
"/releases/index.html",
"/releases/"
{% for v in versions %}
,"/releases/{{ v }}.html"
{% endfor %}
]
},
{
"title": "Staged Release Process",
"urls": [
Expand Down
2 changes: 1 addition & 1 deletion src/current/_layouts/homepage.html
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,7 @@ <h4 class="mt-auto mb-0 text-electric-purple font-poppins-sb">Learn more <img c

<div class="row pt-5 mt-5 pb-5 mb-5">
<div class="col-lg-8">
<a class="btn btn-redirect mt-3" href="{{ '/releases/index.html#production-releases' | relative_url }}">Download the CockroachDB binary <img class="m-0" src="{{ 'images/arrow-left.svg' | relative_url }}" alt="arrow left" /></a>
<a class="btn btn-redirect mt-3" href="{{ '/releases/index.html' | relative_url }}">Download the CockroachDB binary <img class="m-0" src="{{ 'images/arrow-left.svg' | relative_url }}" alt="arrow left" /></a>
</div>
</div>

Expand Down
2 changes: 1 addition & 1 deletion src/current/advisories/a72839.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ Cockroach Labs has diagnosed the above-described problem, and is tracking progre

We plan to improve this issue in an expedited patch version v21.2.1 in the coming days. This advisory will be updated after that release.

You can track releases on our [releases page](https://www.cockroachlabs.com/docs/releases#production-releases).
You can track releases on our [releases page](https://www.cockroachlabs.com/docs/releases).
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
You can track releases on our [releases page](https://www.cockroachlabs.com/docs/releases).
You can track releases on [CockroachDB Releases Overview](https://www.cockroachlabs.com/docs/releases).


## Mitigation

Expand Down
2 changes: 1 addition & 1 deletion src/current/cockroachcloud/troubleshooting-page.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ Failed running "sql"

<h4>Solution</h4>

Update to the latest [CockroachDB client]({% link releases/index.md %}#production-releases). You need to use v21.2.5 or later of the CockroachDB client to connect to your cluster without specifying the CA certificate path in the connection string.
Update to the latest [CockroachDB client]({% link releases/index.md %}). You need to use v21.2.5 or later of the CockroachDB client to connect to your cluster without specifying the CA certificate path in the connection string.

### Certificate signed by unknown authority

Expand Down
5 changes: 3 additions & 2 deletions src/current/cockroachcloud/upgrade-policy.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ A cluster running an unsupported CockroachDB version is not eligible for Cockroa

### Version and upgrade support by cloud plan

[Major versions]({% link releases/index.md %}) of CockroachDB are labeled either as [Regular releases]({% link releases/index.md %}#major-releases) or [Innovation releases]({% link releases/index.md %}#major-releases).
[Major versions]({% link releases/index.md %}) of CockroachDB are labeled either as [Regular releases]({% link releases/index.md %}#major-versions) or [Innovation releases]({% link releases/index.md %}#major-versions).

- **Regular releases** are supported for 12 months from their initial production release date.
- **Innovation releases** are supported for 6 months from their initial production release date.
Expand Down Expand Up @@ -51,8 +51,8 @@ The following table describes currently-supported versions on {{ site.data.produ

Version | Release Type | Release date | End-of-support (EOS) date
:------:|:------------:|:------------:|:---------:
v26.1 | Innovation | 2026-02-02 | 2026-08-02
v25.4 | Regular | 2025-11-03 | 2026-11-03
v25.3 | Innovation | 2025-08-04 | 2026-02-04
v25.2 | Regular | 2025-05-09 | 2026-05-12
v24.3 | Regular | 2024-11-18 | 2026-05-05

Expand All @@ -75,6 +75,7 @@ The following table describes versions that have reached their EOS dates on {{ s

Version | Release Type | Release date | End-of-support (EOS) date
:------:|:------------:|:------------:|:--------:
v25.3 | Innovation | 2025-08-04 | 2026-02-04
v25.1 | Innovation | 2025-02-18 | 2025-08-18
v24.1 | Regular | 2024-05-20 | 2025-05-20
v24.2 | Innovation | 2024-08-12 | 2025-02-12
Expand Down
Loading
Loading