Merge branch 'dev' into select_version

Author: stefano-ottolenghi

.backportrc.json

@@ -0,0 +1,5 @@
+{
+    "repoOwner": "Neo4j",
+    "repoName": "docs-cypher",
+    "prTitle": "[Cherry-pick][{{targetBranch}}] {{commitMessages}}"
+}

.github/workflows/auto-backport.yml

@@ -0,0 +1,28 @@
+name: auto-cherry-pick
+on:
+  pull_request_target:
+    types: ["closed"]
+
+jobs:
+  backport:
+    name: Cherry-pick PR
+    runs-on: [ubuntu-latest]
+    if: |
+      github.event.pull_request.merged == true
+      && contains(github.event.pull_request.labels.*.name, 'cherry-pick')
+      && github.event.action == 'closed'
+    steps:
+      - name: Cherry-pick action
+        uses: sorenlouv/backport-github-action@929f69d04adbc196d982e60f02837b6cc00b3129
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          auto_backport_label_prefix: cherry-pick-to-
+          add_original_reviewers: false
+
+      - name: Info log
+        if: ${{ success() }}
+        run: cat ~/.backport/backport.info.log
+
+      - name: Debug log
+        if: ${{ failure() }}
+        run: cat ~/.backport/backport.debug.log

README.adoc

@@ -40,7 +40,6 @@ To view the built site, launch a local server:
 . `npm start`
 . In a browser tab, go to `localhost:8000`
 
-
 === Live preview
 
 When you run `npm start`, the project is monitored for updates to asciidoc files.
@@ -78,6 +77,37 @@ There are a few edge cases where we might want to work only on the current branc
 * When a new version is ready to published, the `cypher-25` branch will get a git tag, named with the exact version (for example, **2025.01.00**), signifying that this point-in-time marks the completion of the work for that minor release.
 * Updates merged into the `dev` branch for the next release are cherry-picked into the `cypher-25` branch.
 
+
+=== Enable automatic cherry-picking on a PR
+
+To enable automatic cherry-picking on a PR, add the label `cherry-pick` to it.
+Without it, the responsible GitHub action is not going to be triggered.
+
+To select the target branches you would like to cherry-pick your PR to, add labels of the following structure: `cherry-pick-to-<targetBranch>`.
+For example: `cherry-pick-to-cypher-25` to cherry-pick it to the branch `cypher-25` or `cherry-pick-to-5.x` for the branch `5.x`.
+You may even add new labels for branches that do not have such a label yet.
+
+The feature is triggered by either merging a PR with the `cherry-pick` label or by adding the `cherry-pick` label to an already closed and merged PR.
+In the latter case, ensure that you first add the labels containing the target branches and then finally the `cherry-pick` label.
+Otherwise the automation starts without any target branches.
+
+
+==== Details
+
+The PRs created by this GitHub action will have their heading prefixed with `[Cherry-pick][<targetBranch>]`.
+So, for example, for `6.x` as the target branch and `some changes` as the original PR heading, it results in `[Cherry-pick][6.x] some changes` as the heading for the cherry-picked PR.
+In case an assignee was set for the original PR, the cherry-picked PRs will also receive the same assignee.
+You must add reviewers manually after the cherry-picked PRs have been created.
+
+The creation of cherry-picked PRs can take a few minutes.
+If you are an assignee of the original PR, you receive an email notification once the cherry-picked PRs have been created.
+The original PR is updated with a comment that contains links to the newly created cherry-picked PRs.
+
+In case of a merge conflict while cherry-picking to a specific release branch, the branch will be skipped. Information on skipped branches is also included in the comment added to the original PR.
+In that case you will have to take care of cherry-picking manually and resolve the conflicts.
+This is not going to influence the other release branches as long as they do not have conflicts.
+
+
 [[documenting-changes]]
 == Documenting changes to Cypher
 
@@ -117,3 +147,4 @@ When documenting a new Cypher feature, its relationship with GQL must be conside
 * If the feature is part of GQL's optional features, it should be recorded on the page xref:modules/ROOT/pages/appendix/gql-conformance/supported-optional.adoc[Supported optional GQL features].
 * if the feature adds functionality for which there exists an analogous, optional GQL feature, it should be recorded on the page xref:modules/ROOT/pages/appendix/gql-conformance/analogous-cypher.adoc[Optional GQL features and analogous Cypher].
 * If the feature adds functionality for which there exists no GQL equivalent, it should be recorded on the page xref:modules/ROOT/pages/appendix/gql-conformance/additional-cypher.adoc[Additional Cypher features].
+

modules/ROOT/.DS_Store

@@ -10,6 +10,7 @@
 ** xref:queries/composed-queries/index.adoc[]
 *** xref:queries/composed-queries/combined-queries.adoc[]
 *** xref:queries/composed-queries/conditional-queries.adoc[]
+*** xref:queries/composed-queries/sequential-queries.adoc[]
 
 * xref:clauses/index.adoc[]
 ** xref:clauses/clause-composition.adoc[]
@@ -53,20 +54,22 @@
 ** xref:patterns/variable-length-patterns.adoc[]
 ** xref:patterns/shortest-paths.adoc[]
 ** xref:patterns/non-linear-patterns.adoc[]
+** xref:patterns/match-modes.adoc[]
 ** xref:patterns/reference.adoc[]
 
 * xref:values-and-types/index.adoc[]
-** xref:values-and-types/property-structural-constructed.adoc[]
-** xref:values-and-types/temporal.adoc[]
-** xref:values-and-types/spatial.adoc[]
-** xref:values-and-types/working-with-null.adoc[]
-** xref:values-and-types/lists.adoc[]
-** xref:values-and-types/maps.adoc[]
-** xref:values-and-types/casting-data.adoc[]
+** xref::values-and-types/property-structural-constructed.adoc[]
+** xref:values-and-types/boolean-numeric-string.adoc[]
+** xref::values-and-types/temporal.adoc[]
+** xref::values-and-types/spatial.adoc[]
+** xref::values-and-types/lists.adoc[]
+** xref::values-and-types/maps.adoc[]
+** xref:values-and-types/graph-references.adoc[]
+** xref::values-and-types/working-with-null.adoc[]
+** xref::values-and-types/casting-data.adoc[]
 ** xref:values-and-types/ordering-equality-comparison.adoc[]
 
 * xref:expressions/index.adoc[]
-** xref:expressions/expressions-overview.adoc[]
 ** xref:expressions/predicates/index.adoc[]
 *** xref:expressions/predicates/boolean-operators.adoc[]
 *** xref:expressions/predicates/comparison-operators.adoc[]
@@ -136,7 +139,6 @@
 ** xref:syntax/variables.adoc[]
 ** xref:syntax/keywords.adoc[]
 ** xref:syntax/parameters.adoc[]
-** xref:syntax/operators.adoc[]
 ** xref:syntax/comments.adoc[]
 
 * xref:deprecations-additions-removals-compatibility.adoc[]
@@ -152,4 +154,4 @@
 ** xref:appendix/tutorials/index.adoc[]
 *** xref:appendix/tutorials/basic-query-tuning.adoc[]
 *** xref:appendix/tutorials/advanced-query-tuning.adoc[]
-*** xref:appendix/tutorials/shortestpath-planning.adoc[]
+*** xref:appendix/tutorials/shortestpath-planning.adoc[]