add new graph reference deprecations

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

@@ -16,6 +16,40 @@ New features are added to the language continuously, and occasionally, some feat
 This section lists all of the features that have been removed, deprecated, added, or extended in different Cypher versions.
 Replacement syntax for deprecated and removed features are also indicated.
 
+[[cypher-deprecations-additions-removals-2025.06]]
+== Neo4j 2025.06
+
+=== Deprecated features
+
+[cols="2", options="header"]
+|===
+| Feature
+| Details
+
+a|
+[#_graph_reference_removed_name_parts_quoting]
+label:functionality[]
+label:deprecated[]
+[source,cypher]
+----
+CYPHER 5 CREATE ALIAS `foo`.`bar` FOR DATABASE ...
+----
+| Graph references with separately backticked name parts (`++`foo`.`bar`++`) are deprecated.
+In future Cypher versions, use parameters or backtick the entire name (`++`foo.bar`++`).
+
+a|
+[#_graph_reference_updated_graph_by_name_quotes]
+label:functionality[]
+label:deprecated[]
+[source,cypher]
+----
+CYPHER 5 USE graph.byName("`a.b`.c") ...
+----
+| Graph references with separately backticked name parts (`++`a.b`.`c`++`) are deprecated.
+In future Cypher versions, remove the backticks (`a.b.c`).
+
+|===
+
 [[cypher-deprecations-additions-removals-2025.04]]
 == Neo4j 2025.04
 
@@ -246,9 +280,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 has been withdrawn in 2025.06, and replaced by two new deprecations in Cypher 5:
+
+* xref::deprecations-additions-removals-compatibility.adoc#_graph_reference_removed_name_parts_quoting[Deprecated support for quoted name parts in graph references]
+
+* xref::deprecations-additions-removals-compatibility.adoc#_graph_reference_updated_graph_by_name_quotes[Deprecation to graph functions]
+
+This is because the previous quoting rules were inconsistent and ambiguous.
+The rules have been clarified and improved in Cypher 25.
+For more information, see the link:https://neo4j.com/docs/cypher-manual/25/deprecations-additions-removals-compatibility/[Cypher 25 Manual -> Additions, deprecations, removals, and compatibility].
 |===
 
 
@@ -2867,12 +2908,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 dots in the name was deprecated in 5.0.
+However, this deprecation was withdrawn in 2025.06, and replaced by two new deprecations in Cypher 5:
 
-[source, cypher, role="noheader"]
-----
-CREATE DATABASE `databaseName.withDot` ...
-----
+* xref::deprecations-additions-removals-compatibility.adoc#_graph_reference_removed_name_parts_quoting[Deprecated support for quoted name parts in graph references]
+
+* xref::deprecations-additions-removals-compatibility.adoc#_graph_reference_updated_graph_by_name_quotes[Deprecation to graph functions]
+
+This because the previous quoting rules were inconsistent and ambiguous.
+The rules have been clarified and improved in Cypher 25.
+For more information, see the link:https://neo4j.com/docs/cypher-manual/25/deprecations-additions-removals-compatibility/[Cypher 25 Manual -> Additions, deprecations, removals, and compatibility].
 
 a|
 [[cypher-5_0-d_4]]