Merge branch 'main' into 2025-10-01-doc-13854-add-read-from-standby

Author: peachdawnleach

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]{% 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.

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.

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.

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.

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.

src/current/v24.1/follower-reads.md

@@ -65,12 +65,6 @@ To see the current value of the follower read timestamp, execute the following q
 SELECT now() - follower_read_timestamp();
 ~~~
 
-#### Exact staleness follower reads demo
-
-The following video describes and demonstrates [exact staleness](#exact-staleness-reads) follower reads.
-
-{% include_cached youtube.html video_id="V--skgN_JMo" %}
-
 #### Exact staleness follower reads in read-only transactions
 
 You can set the [`AS OF SYSTEM TIME`]({% link {{ page.version.version }}/as-of-system-time.md %}) clause's value for all operations in a read-only [transaction]({% link {{ page.version.version }}/transactions.md %}):
@@ -193,6 +187,12 @@ For further details, see [An Epic Read on Follower Reads](https://www.cockroachl
 
 {% include {{ page.version.version }}/known-limitations/follower-reads-limitations.md %}
 
+### Video demo
+
+For a demo of how to use follower reads to improve performance, watch the following video:
+
+{% include_cached youtube.html video_id="NzhhvgzHJj4" %}
+
 ## See also
 
 - [Follower Reads Topology]({% link {{ page.version.version }}/topology-follower-reads.md %})