Merge branch 'dev' into shortest_fix

Author: JPryce-Aklundh

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

@@ -14,7 +14,7 @@ jobs:
 
   #  Generate HTML
   docs-build-pr:
-    uses: neo4j/docs-tools/.github/workflows/reusable-docs-build.yml@v1.1.2
+    uses: neo4j/docs-tools/.github/workflows/reusable-docs-build.yml@v1.2.0
     with:
       deploy-id: ${{ github.event.number }}
       retain-artifacts: 14
@@ -24,7 +24,7 @@ jobs:
   # By default, the job fails if there are errors, passes if there are warnings only.
   docs-verify-pr:
     needs: docs-build-pr
-    uses: neo4j/docs-tools/.github/workflows/reusable-docs-verify.yml@v1.1.2
+    uses: neo4j/docs-tools/.github/workflows/reusable-docs-verify.yml@v1.2.0
     with:
       failOnWarnings: true
 
@@ -41,7 +41,7 @@ jobs:
     steps:
       - name: Get file changes
         id: get-file-changes
-        uses: tj-actions/changed-files@cbda684547adc8c052d50711417fa61b428a9f88 # v41.1.2
+        uses: tj-actions/changed-files@2f7c5bfce28377bc069a65ba478de0a74aa0ca32 # v46.0.1
         with:
           separator: ','
           files_yaml: |
@@ -56,7 +56,7 @@ jobs:
   docs-updates-comment-pr:
     if: needs.docs-build-pr.outputs.pages-listed == 'success'
     needs: [docs-build-pr, docs-changes-pr]
-    uses: neo4j/docs-tools/.github/workflows/reusable-docs-pr-changes.yml@v1.1.2
+    uses: neo4j/docs-tools/.github/workflows/reusable-docs-pr-changes.yml@v1.2.0
     with:
       pages-modified: ${{ needs.docs-changes-pr.outputs.pages-modified }}
       pages-added: ${{ needs.docs-changes-pr.outputs.pages-added }}

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

@@ -16,6 +16,34 @@ 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.03]]
+== Neo4j 2025.03
+
+=== New features
+
+[cols="2", options="header"]
+|===
+| Feature
+| Details
+
+a|
+label:functionality[]
+label:new[]
+[source, cypher, role=noheader]
+----
+UNWIND range(1, 100) AS i
+CALL (i) {
+    MERGE (u:User {id: i})
+    ON CREATE SET u.created = timestamp()
+} IN TRANSACTIONS ON ERROR RETRY 1 SECOND THEN FAIL
+----
+
+| New error handling option for `CALL { ... } IN TRANSACTIONS`: `ON ERROR RETRY`.
+This option applies an exponential delay between retries for transaction batches failing due to transient errors, with an optional maximum retry duration, and handles failure based on a specified fallback error mode if the transaction does not succeed within the given time.
+For more information, see xref:subqueries/subqueries-in-transactions#on-error-retry[`CALL` subqueries in transactions -> `ON ERROR RETRY`].
+
+|===
+
 [[cypher-deprecations-additions-removals-2025.01]]
 == Neo4j 2025.01
 

modules/ROOT/pages/functions/list.adoc

@@ -230,16 +230,23 @@ Three lists of numbers in the given ranges are returned.
 
 .Details
 |===
-| *Syntax* 3+| `reduce(accumulator, variable)`
+| *Syntax* 3+| `reduce(accumulator = initial, variable IN list \| expression)`
 | *Description* 3+| Runs an expression against individual elements of a `LIST<ANY>`, storing the result of the expression in an accumulator.
-.3+| *Arguments* | *Name* | *Type* | *Description*
-| `accumulator` | `ANY` | A variable that holds the result as the list is iterated.
-| `variable` | `LIST<ANY>` | A variable that can be used within the reducing expression.
+.6+| *Arguments* | *Name* | *Type* | *Description*
+| `accumulator` | `ANY` | A variable that holds the result as the `list` is iterated.
+Starts with an `initial` value.
+| `initial` | `ANY` | The starting value of the `accumulator`.
+| `variable` | `ANY` | A variable that represents each element in the `list` during iteration.
+| `list` | `LIST<ANY>` | The `list` that is being iterated over.
+| `expression` | `ANY` | An expression that updates the `accumulator` with each iteration.
 | *Returns* 3+| `ANY`
 |===
 
-This function is analogous to the `fold` or `reduce` method in functional languages such as Lisp and Scala.
-
+.Considerations
+|===
+|`reduce()` differs from most Cypher functions because it iterates over a list, incrementally updating an accumulator with each element based on an expression, rather than returning a result from a single evaluation.
+As such, Cypher's `reduce()` is analogous to the `fold` or `reduce` methods in functional languages such as Lisp and Scala.
+|===
 
 .+reduce()+
 ======

modules/ROOT/pages/functions/predicate.adoc

@@ -53,6 +53,7 @@ CREATE
 
 .Considerations
 |===
+| `all()` differs from most Cypher functions because it iterates over a list, evaluating an expression for each element, rather than returning a result from a single evaluation.
 | `null` is returned if the `list` is `null` or if the `predicate` evaluates to `null` for at least one element and does not evaluate to false for any other element.
 | `all()` returns `true` if `list` is empty because there are no elements to falsify the `predicate`.
 |===
@@ -123,6 +124,7 @@ RETURN all(i in emptyList WHERE true) as allTrue, all(i in emptyList WHERE false
 
 .Considerations
 |===
+| `any()` differs from most Cypher functions because it iterates over a list, evaluating an expression for each element, rather than returning a result from a single evaluation.
 | `null` is returned if the `list` is `null` or if the `predicate` evaluates to `null` for at least one element and does not evaluate to false for any other element.
 | `any()` returns `false` if `list` is empty because there are no elements to satisfy the `predicate`.
 |===
@@ -348,6 +350,7 @@ xref:syntax/operators.adoc#cypher-comparison[`IS NULL` or `IS NOT NULL`] should
 
 .Considerations
 |===
+| `none()` differs from most Cypher functions because it iterates over a list, evaluating an expression for each element, rather than returning a result from a single evaluation.
 | `null` is returned if the `list` is `null`, or if the `predicate` evaluates to `null` for at least one element and does not evaluate to `true` for any other element.
 | `none()` returns `true` if `list` is empty because there are no elements to violate the `predicate`.
 |===
@@ -419,6 +422,7 @@ RETURN none(i IN emptyList WHERE true) as noneTrue, none(i IN emptyList WHERE fa
 
 .Considerations
 |===
+| `single()` differs from most Cypher functions because it iterates over a list, evaluating an expression for each element, rather than returning a result from a single evaluation.
 | `null` is returned if the `list` is `null`, or if the `predicate` evaluates to `null` for at least one element and does not evaluate to `true` for any other element.
 | `single()` returns `false` if `list` is empty because there is not exactly one element satisfying the `predicate`.
 |===

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

@@ -256,7 +256,7 @@ Use xref:functions/vector.adoc[] to compute the similarity score between two spe
 [[performance]]
 == Performance suggestions
 
-Vector indexes can take advantage of the incubated Java 20 Vector API for noticeable speed improvements.
+Vector indexes can take advantage of the incubated Java Vector API for noticeable speed improvements.
 If you are using a compatible version of Java, you can add the following setting to your link:{neo4j-docs-base-uri}/operations-manual/current/configuration/configuration-settings/#config_server.jvm.additional[configuration settings]:
 
 .Configuration settings
@@ -265,6 +265,11 @@ If you are using a compatible version of Java, you can add the following setting
 server.jvm.additional=--add-modules=jdk.incubator.vector
 ----
 
+[NOTE]
+While the Neo4j 5 series requires at least Java 17, _at least_ Java 20 is necessary to take advantage of this performance improvement in Neo4j 5.14-5.26.
+If you are using Neo4j 2025.01 or later, Java 21 is required.
+For more information about what Java versions are supported by different Neo4j versions, see the link:{neo4j-docs-base-uri}/operations-manual/current/installation/requirements/#deployment-requirements-java[Operations Manual -> System requirements -> Java].
+
 [[show-vector-indexes]]
 == Show vector indexes