From b71345b3c0fd2a0f55109c082a254758a72327d0 Mon Sep 17 00:00:00 2001 From: Rich Loveland Date: Thu, 9 Oct 2025 16:08:07 -0400 Subject: [PATCH 1/3] Link 'Enable super region' to something useful Fixes DOC-12942 --- src/current/_includes/v24.1/sql/super-region-considerations.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/current/_includes/v24.1/sql/super-region-considerations.md b/src/current/_includes/v24.1/sql/super-region-considerations.md index 596e21e3717..ff10dc573c3 100644 --- a/src/current/_includes/v24.1/sql/super-region-considerations.md +++ b/src/current/_includes/v24.1/sql/super-region-considerations.md @@ -1,7 +1,7 @@ To use super regions, keep the following considerations in mind: - Your cluster must be a [multi-region cluster]({% link {{ page.version.version }}/multiregion-overview.md %}). -- Super regions [must be enabled](#enable-super-regions). +- Super regions [must be enabled]({% link {{ page.version.version }}/alter-database.md %}#enable-super-regions). - Super regions can only contain one or more [database regions]({% link {{ page.version.version }}/multiregion-overview.md %}#database-regions) that have already been added with [`ALTER DATABASE ... ADD REGION`]({% link {{ page.version.version }}/alter-database.md %}#add-region). - Each database region can only belong to one super region. In other words, given two super regions _A_ and _B_, the set of database regions in _A_ must be [disjoint](https://wikipedia.org/wiki/Disjoint_sets) from the set of database regions in _B_. - You cannot [drop a region]({% link {{ page.version.version }}/alter-database.md %}#drop-region) that is part of a super region until you either [alter the super region]({% link {{ page.version.version }}/alter-database.md %}#alter-super-region) to remove it, or [drop the super region]({% link {{ page.version.version }}/alter-database.md %}#drop-super-region) altogether. From d9a639437948e064d3ebf90d0a23006be3d08daa Mon Sep 17 00:00:00 2001 From: Rich Loveland Date: Fri, 10 Oct 2025 13:40:11 -0400 Subject: [PATCH 2/3] Update with bsanchez-the-roach feedback (1) Updated link with conditional logic based on page --- src/current/_includes/v24.1/sql/super-region-considerations.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/current/_includes/v24.1/sql/super-region-considerations.md b/src/current/_includes/v24.1/sql/super-region-considerations.md index ff10dc573c3..935d7784406 100644 --- a/src/current/_includes/v24.1/sql/super-region-considerations.md +++ b/src/current/_includes/v24.1/sql/super-region-considerations.md @@ -1,7 +1,7 @@ To use super regions, keep the following considerations in mind: - Your cluster must be a [multi-region cluster]({% link {{ page.version.version }}/multiregion-overview.md %}). -- Super regions [must be enabled]({% link {{ page.version.version }}/alter-database.md %}#enable-super-regions). +- Super regions [must be enabled]{% if page.name == "show-super-regions.md" %}(#enable-super-regions){% else %}({% link {{ page.version.version }}/alter-database.md %}#enable-super-regions){% endif %}. - Super regions can only contain one or more [database regions]({% link {{ page.version.version }}/multiregion-overview.md %}#database-regions) that have already been added with [`ALTER DATABASE ... ADD REGION`]({% link {{ page.version.version }}/alter-database.md %}#add-region). - Each database region can only belong to one super region. In other words, given two super regions _A_ and _B_, the set of database regions in _A_ must be [disjoint](https://wikipedia.org/wiki/Disjoint_sets) from the set of database regions in _B_. - You cannot [drop a region]({% link {{ page.version.version }}/alter-database.md %}#drop-region) that is part of a super region until you either [alter the super region]({% link {{ page.version.version }}/alter-database.md %}#alter-super-region) to remove it, or [drop the super region]({% link {{ page.version.version }}/alter-database.md %}#drop-super-region) altogether. From daa28ec3cda26aab936623374bdf7fdff0119b0f Mon Sep 17 00:00:00 2001 From: Rich Loveland Date: Tue, 14 Oct 2025 11:46:11 -0400 Subject: [PATCH 3/3] Port changes to supported versions v24.1 and later --- src/current/_includes/v24.3/sql/super-region-considerations.md | 2 +- src/current/_includes/v25.1/sql/super-region-considerations.md | 2 +- src/current/_includes/v25.3/sql/super-region-considerations.md | 2 +- src/current/_includes/v25.4/sql/super-region-considerations.md | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/src/current/_includes/v24.3/sql/super-region-considerations.md b/src/current/_includes/v24.3/sql/super-region-considerations.md index 596e21e3717..935d7784406 100644 --- a/src/current/_includes/v24.3/sql/super-region-considerations.md +++ b/src/current/_includes/v24.3/sql/super-region-considerations.md @@ -1,7 +1,7 @@ To use super regions, keep the following considerations in mind: - Your cluster must be a [multi-region cluster]({% link {{ page.version.version }}/multiregion-overview.md %}). -- Super regions [must be enabled](#enable-super-regions). +- Super regions [must be enabled]{% if page.name == "show-super-regions.md" %}(#enable-super-regions){% else %}({% link {{ page.version.version }}/alter-database.md %}#enable-super-regions){% endif %}. - Super regions can only contain one or more [database regions]({% link {{ page.version.version }}/multiregion-overview.md %}#database-regions) that have already been added with [`ALTER DATABASE ... ADD REGION`]({% link {{ page.version.version }}/alter-database.md %}#add-region). - Each database region can only belong to one super region. In other words, given two super regions _A_ and _B_, the set of database regions in _A_ must be [disjoint](https://wikipedia.org/wiki/Disjoint_sets) from the set of database regions in _B_. - You cannot [drop a region]({% link {{ page.version.version }}/alter-database.md %}#drop-region) that is part of a super region until you either [alter the super region]({% link {{ page.version.version }}/alter-database.md %}#alter-super-region) to remove it, or [drop the super region]({% link {{ page.version.version }}/alter-database.md %}#drop-super-region) altogether. diff --git a/src/current/_includes/v25.1/sql/super-region-considerations.md b/src/current/_includes/v25.1/sql/super-region-considerations.md index 596e21e3717..935d7784406 100644 --- a/src/current/_includes/v25.1/sql/super-region-considerations.md +++ b/src/current/_includes/v25.1/sql/super-region-considerations.md @@ -1,7 +1,7 @@ To use super regions, keep the following considerations in mind: - Your cluster must be a [multi-region cluster]({% link {{ page.version.version }}/multiregion-overview.md %}). -- Super regions [must be enabled](#enable-super-regions). +- Super regions [must be enabled]{% if page.name == "show-super-regions.md" %}(#enable-super-regions){% else %}({% link {{ page.version.version }}/alter-database.md %}#enable-super-regions){% endif %}. - Super regions can only contain one or more [database regions]({% link {{ page.version.version }}/multiregion-overview.md %}#database-regions) that have already been added with [`ALTER DATABASE ... ADD REGION`]({% link {{ page.version.version }}/alter-database.md %}#add-region). - Each database region can only belong to one super region. In other words, given two super regions _A_ and _B_, the set of database regions in _A_ must be [disjoint](https://wikipedia.org/wiki/Disjoint_sets) from the set of database regions in _B_. - You cannot [drop a region]({% link {{ page.version.version }}/alter-database.md %}#drop-region) that is part of a super region until you either [alter the super region]({% link {{ page.version.version }}/alter-database.md %}#alter-super-region) to remove it, or [drop the super region]({% link {{ page.version.version }}/alter-database.md %}#drop-super-region) altogether. diff --git a/src/current/_includes/v25.3/sql/super-region-considerations.md b/src/current/_includes/v25.3/sql/super-region-considerations.md index 596e21e3717..935d7784406 100644 --- a/src/current/_includes/v25.3/sql/super-region-considerations.md +++ b/src/current/_includes/v25.3/sql/super-region-considerations.md @@ -1,7 +1,7 @@ To use super regions, keep the following considerations in mind: - Your cluster must be a [multi-region cluster]({% link {{ page.version.version }}/multiregion-overview.md %}). -- Super regions [must be enabled](#enable-super-regions). +- Super regions [must be enabled]{% if page.name == "show-super-regions.md" %}(#enable-super-regions){% else %}({% link {{ page.version.version }}/alter-database.md %}#enable-super-regions){% endif %}. - Super regions can only contain one or more [database regions]({% link {{ page.version.version }}/multiregion-overview.md %}#database-regions) that have already been added with [`ALTER DATABASE ... ADD REGION`]({% link {{ page.version.version }}/alter-database.md %}#add-region). - Each database region can only belong to one super region. In other words, given two super regions _A_ and _B_, the set of database regions in _A_ must be [disjoint](https://wikipedia.org/wiki/Disjoint_sets) from the set of database regions in _B_. - You cannot [drop a region]({% link {{ page.version.version }}/alter-database.md %}#drop-region) that is part of a super region until you either [alter the super region]({% link {{ page.version.version }}/alter-database.md %}#alter-super-region) to remove it, or [drop the super region]({% link {{ page.version.version }}/alter-database.md %}#drop-super-region) altogether. diff --git a/src/current/_includes/v25.4/sql/super-region-considerations.md b/src/current/_includes/v25.4/sql/super-region-considerations.md index 596e21e3717..935d7784406 100644 --- a/src/current/_includes/v25.4/sql/super-region-considerations.md +++ b/src/current/_includes/v25.4/sql/super-region-considerations.md @@ -1,7 +1,7 @@ To use super regions, keep the following considerations in mind: - Your cluster must be a [multi-region cluster]({% link {{ page.version.version }}/multiregion-overview.md %}). -- Super regions [must be enabled](#enable-super-regions). +- Super regions [must be enabled]{% if page.name == "show-super-regions.md" %}(#enable-super-regions){% else %}({% link {{ page.version.version }}/alter-database.md %}#enable-super-regions){% endif %}. - Super regions can only contain one or more [database regions]({% link {{ page.version.version }}/multiregion-overview.md %}#database-regions) that have already been added with [`ALTER DATABASE ... ADD REGION`]({% link {{ page.version.version }}/alter-database.md %}#add-region). - Each database region can only belong to one super region. In other words, given two super regions _A_ and _B_, the set of database regions in _A_ must be [disjoint](https://wikipedia.org/wiki/Disjoint_sets) from the set of database regions in _B_. - You cannot [drop a region]({% link {{ page.version.version }}/alter-database.md %}#drop-region) that is part of a super region until you either [alter the super region]({% link {{ page.version.version }}/alter-database.md %}#alter-super-region) to remove it, or [drop the super region]({% link {{ page.version.version }}/alter-database.md %}#drop-super-region) altogether.