update removals & deprecations for graph references (#1315)

see also: neo4j/docs-status-codes#340

---------

Co-authored-by: Jens Pryce-Åklundh <[email protected]>

Author: nadja-muller

modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc

@@ -51,6 +51,20 @@ CREATE DATABASE db OPTIONS { existingDataSeedInstance: ... }
 | The option `existingDataSeedInstance` is removed from the `CREATE DATABASE` `OPTIONS` map and replaced by `existingDataSeedServer`.
 For more information, see link:{neo4j-docs-base-uri}/operations-manual/current/database-administration/standard-databases/create-databases/#manage-databases-create-database-options[Operations Manual -> Database administration -> Create databases].
 
+a|
+[#_graph_reference_removed_name_parts_quoting]
+label:functionality[]
+label:removed[]
+[source, cypher, role=noheader]
+----
+CREATE ALIAS composite.`1` FOR DATABASE neo4j
+----
+[source, cypher, role=noheader]
+----
+USE composite.`1`
+----
+| Graph references with separately backticked name parts have been removed. Use parameters or backtick the entire name, e.g. `USE `composite.1``
+
 
 a|
 label:functionality[]
@@ -278,6 +292,7 @@ Several  xref:clauses/transaction-clauses.adoc#query-listing-transactions[`SHOW
 * The current query-related columns — `currentQuery`, `currentQueryId`, `parameters`, `planner`, `runtime`, `indexes`, `currentQueryStartTime`, `currentQueryElapsedTime`, `currentQueryCpuTime`, `currentQueryIdleTime`, and `currentQueryStatus` — now return `null` when no query is executing.
 
 a|
+[#_graph_reference_updated_graph_by_name_quotes]
 label:functionality[]
 label:updated[]
 [source, cypher, role="noheader"]
@@ -732,9 +747,16 @@ label:deprecated[]
 USE my.db ...
 
 ----
-| In xref:clauses/use.adoc[`USE`] clauses, databases and aliases with unquoted `.` are deprecated unless the `.` is used to indicate that the database or alias belongs to a composite database.
-Names containing `.` should be quoted using backticks. 
-For example, `USE `my.db`` is valid.
+a| The use of unquoted `.` characters in xref:clauses/use.adoc[`USE`] clauses when specifying databases and aliases was deprecated in 5.26, except when `.` indicated that the database or alias belonged to a composite database.
+However, this deprecation was withdrawn in Neo4j 2025.06, and replaced by the following updates in Cypher 25:
+
+* xref::deprecations-additions-removals-compatibility.adoc#_graph_reference_removed_name_parts_quoting[Removed support for quoted name parts in graph references]
+
+* xref::deprecations-additions-removals-compatibility.adoc#_graph_reference_updated_graph_by_name_quotes[Update to graph functions]
+
+This is because the previous quoting rules were inconsistent and ambiguous.
+The rules are clarified and improved in Cypher 25.
+For more information, see xref::values-and-types/graph-references.adoc#rules[Graph reference rules]
 
 |===
 
@@ -3353,12 +3375,16 @@ label:deprecated[]
 CREATE DATABASE databaseName.withDot ...
 ----
 a|
-Creating a database with dots in the name has been deprecated, instead quote the database name using backticks:
+Creating a database with . characters was deprecated in 5.0.
+However, this deprecation was withdrawn in 2025.06, and replaced by the following updates in Cypher 25:
 
-[source, cypher, role="noheader"]
-----
-CREATE DATABASE `databaseName.withDot` ...
-----
+* xref::deprecations-additions-removals-compatibility.adoc#_graph_reference_removed_name_parts_quoting[Removed support for quoted name parts in graph references]
+
+* xref::deprecations-additions-removals-compatibility.adoc#_graph_reference_updated_graph_by_name_quotes[Update to graph functions]
+
+This is because the previous quoting rules were inconsistent and ambiguous.
+The rules are clarified and improved in Cypher 25.
+For more information, see xref::values-and-types/graph-references.adoc#rules[Graph reference rules]
 
 a|
 [[cypher-5_0-d_4]]