From 2e191f8aa6a9b976ad3d72d4376e47225a217ff2 Mon Sep 17 00:00:00 2001
From: Ryan Kuo <8740013+taroface@users.noreply.github.com>
Date: Tue, 17 Dec 2024 13:25:54 -0500
Subject: [PATCH 1/6] update path to BEGIN diagram in 22.2-23.2 (#19229)
---
src/current/v22.2/begin-transaction.md | 2 +-
src/current/v23.1/begin-transaction.md | 7 +++----
src/current/v23.2/begin-transaction.md | 2 +-
3 files changed, 5 insertions(+), 6 deletions(-)
diff --git a/src/current/v22.2/begin-transaction.md b/src/current/v22.2/begin-transaction.md
index d071eea8165..3e9966642f4 100644
--- a/src/current/v22.2/begin-transaction.md
+++ b/src/current/v22.2/begin-transaction.md
@@ -15,7 +15,7 @@ When using transactions, your application should include logic to [retry transac
## Synopsis
-{% remote_include https://raw.githubusercontent.com/cockroachdb/generated-diagrams/{{ page.release_info.crdb_branch_name }}/grammar_svg/begin.html %}
+{% remote_include https://raw.githubusercontent.com/cockroachdb/generated-diagrams/{{ page.release_info.crdb_branch_name }}/grammar_svg/legacy_begin.html %}
## Required privileges
diff --git a/src/current/v23.1/begin-transaction.md b/src/current/v23.1/begin-transaction.md
index 685a395a2f1..b2cbef9a048 100644
--- a/src/current/v23.1/begin-transaction.md
+++ b/src/current/v23.1/begin-transaction.md
@@ -7,15 +7,14 @@ docs_area: reference.sql
The `BEGIN` [statement]({% link {{ page.version.version }}/sql-statements.md %}) initiates a [transaction]({% link {{ page.version.version }}/transactions.md %}), which either successfully executes all of the statements it contains or none at all.
-{{site.data.alerts.callout_danger}}
-When using transactions, your application should include logic to [retry transactions]({% link {{ page.version.version }}/transactions.md %}#transaction-retries) that are aborted to break a dependency cycle between concurrent transactions.
+{{site.data.alerts.callout_info}}
+When running under the default [`SERIALIZABLE`]({% link {{ page.version.version }}/demo-serializable.md %}) isolation level, your application should [use a retry loop to handle transaction retry errors]({% link {{ page.version.version }}/query-behavior-troubleshooting.md %}#transaction-retry-errors) that can occur under [contention]({{ link_prefix }}performance-best-practices-overview.html#transaction-contention).
{{site.data.alerts.end}}
-
## Synopsis
-{% remote_include https://raw.githubusercontent.com/cockroachdb/generated-diagrams/{{ page.release_info.crdb_branch_name }}/grammar_svg/begin.html %}
+{% remote_include https://raw.githubusercontent.com/cockroachdb/generated-diagrams/{{ page.release_info.crdb_branch_name }}/grammar_svg/legacy_begin.html %}
## Required privileges
diff --git a/src/current/v23.2/begin-transaction.md b/src/current/v23.2/begin-transaction.md
index abee0930220..6c50b135e95 100644
--- a/src/current/v23.2/begin-transaction.md
+++ b/src/current/v23.2/begin-transaction.md
@@ -14,7 +14,7 @@ When running under the default [`SERIALIZABLE`]({% link {{ page.version.version
## Synopsis
-{% remote_include https://raw.githubusercontent.com/cockroachdb/generated-diagrams/{{ page.release_info.crdb_branch_name }}/grammar_svg/begin.html %}
+{% remote_include https://raw.githubusercontent.com/cockroachdb/generated-diagrams/{{ page.release_info.crdb_branch_name }}/grammar_svg/legacy_begin.html %}
## Required privileges
From 7c3056cf42e3e01c30bee01fcba855cdf1d7c2e5 Mon Sep 17 00:00:00 2001
From: Ryan Kuo <8740013+taroface@users.noreply.github.com>
Date: Tue, 17 Dec 2024 15:22:37 -0500
Subject: [PATCH 2/6] update SQL Feature Support page (#19247)
---
src/current/v24.3/sql-feature-support.md | 10 ++++------
1 file changed, 4 insertions(+), 6 deletions(-)
diff --git a/src/current/v24.3/sql-feature-support.md b/src/current/v24.3/sql-feature-support.md
index 3ca62dbbc71..df9fa0711d8 100644
--- a/src/current/v24.3/sql-feature-support.md
+++ b/src/current/v24.3/sql-feature-support.md
@@ -1,18 +1,16 @@
---
-title: SQL Feature Support in CockroachDB v24.2
+title: SQL Feature Support in CockroachDB
summary: Summary of CockroachDB's conformance to the SQL standard and which common extensions it supports.
toc: true
keywords: gin, gin index, gin indexes, inverted index, inverted indexes, accelerated index, accelerated indexes
docs_area: reference.sql
---
-Making CockroachDB easy to use is a top priority for us, so we chose to implement SQL. However, even though SQL has a standard, no database implements all of it, nor do any of them have standard implementations of all features.
-
-To understand which standard SQL features we support (as well as common extensions to the standard), use the table below.
+CockroachDB {{ page.version.version }} supports the following standard SQL features and common extensions.
- **Component** lists the components that are commonly considered part of SQL.
- **Supported** shows CockroachDB's level of support for the component.
-- **Type** indicates whether the component is part of the SQL *Standard* or is an *Extension* created by ourselves or others.
+- **Type** indicates whether the component is part of the SQL *Standard* or is an *Extension* created by Cockroach Labs or others.
- **Details** provides greater context about the component.