Merge branch 'cypher-5' into 5-cherry-pick-1123

Author: JPryce-Aklundh

.github/workflows/docs-pr-checks.yml

@@ -5,10 +5,8 @@ on:
   pull_request:
     branches:
     - "dev"
-    - "5.x"
-    - "4.[0-9]"
-    - "3.5"
-
+    - "cypher-25"
+    - "cypher-5"
 
 jobs:
 

.github/workflows/docs-teardown.yml

@@ -5,9 +5,9 @@ on:
   pull_request_target:
     branches:
       - "dev"
-      - "5.x"
-      - "4.[0-9]"
-      - "3.5"
+      - "cypher-25"
+      - "cypher-5"
+
     types:
       - closed
 

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

@@ -28,6 +28,40 @@ For more information, see:
 * link:https://neo4j.com/docs/cypher-manual/25/introduction/[Cypher 25 Manual]
 ====
 
+[[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
 
@@ -258,9 +292,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].
 |===
 
 
@@ -2879,12 +2920,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]]

modules/ROOT/pages/indexes/semantic-indexes/vector-indexes.adoc

@@ -1,6 +1,6 @@
 :description: Information about creating, querying, and deleting vector indexes with Cypher.
 :page-role: new-5.13
-:test-setup-dump: https://github.com/neo4j-graph-examples/recommendations/raw/main/data/recommendations-embeddings-50.dump
+:test-setup-dump: https://github.com/neo4j-graph-examples/recommendations/raw/main/data/recommendations-embeddings-aligned-5.26.dump
 :l2-norm: image:l2.svg["l2"]-norm
 include::https://raw.githubusercontent.com/neo4j-graphacademy/courses/main/asciidoc/courses/llm-vectors-unstructured/ad.adoc[]