Clarify situation around the UNION reordering deprecation (#224)

Supersedes #219 --------- Co-authored-by: Reneta Popova <[email protected]>
neo4j · Nov 27, 2024 · 0076963 · 0076963
1 parent bc9b2e2
commit 0076963
Showing 1 changed file with 7 additions and 22 deletions.
diff --git a/modules/ROOT/pages/notifications/all-notifications.adoc b/modules/ROOT/pages/notifications/all-notifications.adoc
@@ -1373,7 +1373,7 @@ a|
 To continue using it, escape the identifier by adding backticks around the identifier `%s`.
 - The character with the Unicode representation `%s` is deprecated for unescaped identifiers and will not be supported in the future.
 To continue using it, escape the identifier by adding backticks around the identifier `%s`.
-- All subqueries in a UNION [ALL] should have the same ordering for the return columns.
+- label:new[Valid for Neo4j 5.5-5.25] All subqueries in a UNION [ALL] should have the same ordering for the return columns.
 Using differently ordered return items in a UNION [ALL] clause is deprecated and will be removed in a future version.
 - Databases and aliases with unescaped `.` are deprecated unless to indicate that they belong to a composite database.
 Names containing `.` should be escaped. (`%s`)
@@ -1458,17 +1458,6 @@ Description of the returned code::
 All subqueries in a UNION [ALL] should have the same ordering for the return columns.
 Using differently ordered return items in a UNION [ALL] clause is deprecated and will be removed in a future version.
 
-Suggestions for improvement::
-Use the same order for the return columns in all subqueries combined by a `UNION` clause.
-
-+
-[source,cypher]
-----
-RETURN 'val' as one, 'val' as two
-UNION
-RETURN 'val' as one, 'val' as two
-----
-
 ======
 [.include-with-GQLSTATUS-code]
 ======
@@ -1489,19 +1478,15 @@ warn: feature deprecated.
 All subqueries in a UNION [ALL] should have the same ordering for the return columns.
 Using differently ordered return items in a UNION [ALL] clause is deprecated and will be removed in a future version.
 
-Suggestions for improvement::
-Use the same order for the return columns in all subqueries combined by a `UNION` clause.
-
-+
-[source,cypher]
-----
-RETURN 'val' as one, 'val' as two
-UNION
-RETURN 'val' as one, 'val' as two
-----
 ======
 =====
 
+[NOTE]
+====
+Using differently ordered return items in a UNION [ALL] clause is deprecated in versions 5.5 to 5.25.
+However, starting from version 5.26, the deprecation has been withdrawn following cost-benefit analysis and valuable user feedback.
+====
+
 .Using the Unicode \u0085 in an unescaped identifier
 [.tabbed-example]
 =====