From 0a6fd917f1790a25163082c6d46d79bcdd1a10bb Mon Sep 17 00:00:00 2001
From: Richard Sill <richard.sill@neo4j.com>
Date: Wed, 18 Dec 2024 11:35:26 +0100
Subject: [PATCH 1/9] tags for the FINISH clause

---
 modules/ROOT/pages/clauses/finish.adoc | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/modules/ROOT/pages/clauses/finish.adoc b/modules/ROOT/pages/clauses/finish.adoc
index b233b4896..a55dd9392 100644
--- a/modules/ROOT/pages/clauses/finish.adoc
+++ b/modules/ROOT/pages/clauses/finish.adoc
@@ -9,20 +9,24 @@ A query ending in `FINISH` — instead of `RETURN` — has no result but execute
 The following read query successfully executes but has no results:
 
 .Query
+tag::clauses_finish_match[]
 [source, cypher]
 ----
 MATCH (p:Person)
 FINISH
 ----
+end::clauses_finish_match[]
 
 The following query has no result but creates one node with the label `Person`:
 
 .Query
+tag::clauses_finish_create[]
 [source, cypher]
 ----
 CREATE (p:Person)
 FINISH
 ----
+end::clauses_finish_create[]
 
 It is equivalent to the following query:
 

From f9594236afa768f9146620c4dbf013d42145cc45 Mon Sep 17 00:00:00 2001
From: Richard Sill <richard.sill@neo4j.com>
Date: Wed, 18 Dec 2024 12:05:12 +0100
Subject: [PATCH 2/9] tags for the USE clause

---
 modules/ROOT/pages/clauses/finish.adoc | 2 +-
 modules/ROOT/pages/clauses/use.adoc    | 6 +++++-
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/modules/ROOT/pages/clauses/finish.adoc b/modules/ROOT/pages/clauses/finish.adoc
index a55dd9392..816ae1665 100644
--- a/modules/ROOT/pages/clauses/finish.adoc
+++ b/modules/ROOT/pages/clauses/finish.adoc
@@ -3,7 +3,7 @@
 [[query-finish]]
 = FINISH
 
-A query ending in `FINISH` — instead of `RETURN` — has no result but executes all its side effects.
+A query ending in `FINISH` -- instead of `RETURN` -- has no result but executes all its side effects.
 `FINISH` was introduced as part of Cypher's xref:appendix/gql-conformance/index.adoc[].
 
 The following read query successfully executes but has no results:
diff --git a/modules/ROOT/pages/clauses/use.adoc b/modules/ROOT/pages/clauses/use.adoc
index 1d5643469..a6045f548 100644
--- a/modules/ROOT/pages/clauses/use.adoc
+++ b/modules/ROOT/pages/clauses/use.adoc
@@ -68,14 +68,16 @@ CREATE ALIAS `myComposite`.`myConstituent` FOR DATABASE `myDatabase`;
 [[query-use-examples-query-graph]]
 === Query a graph
 
-In this example it is assumed that the DBMS contains a database named `myDatabase`:
+This example assumes that the DBMS contains a database named `myDatabase`:
 
 .Query
+tag::clauses_use[]
 [source, cypher]
 ----
 USE myDatabase
 MATCH (n) RETURN n
 ----
+end::clauses_use[]
 
 [[query-use-examples-query-composite-database-constituent-graph]]
 === Query a composite database constituent graph
@@ -83,11 +85,13 @@ MATCH (n) RETURN n
 In this example it is assumed that the DBMS contains a composite database named `myComposite`, which includes an alias named `myConstituent`:
 
 .Query
+tag::clauses_use_composite[]
 [source, cypher]
 ----
 USE myComposite.myConstituent
 MATCH (n) RETURN n
 ----
+end::clauses_use_composite[]
 
 
 [[query-use-examples-query-composite-database-constituent-graph-dynamically]]

From 943cf62b8996aea6b84f2c04de40e514b7f9dca7 Mon Sep 17 00:00:00 2001
From: Richard Sill <richard.sill@neo4j.com>
Date: Wed, 18 Dec 2024 16:09:52 +0100
Subject: [PATCH 3/9] tags for ORDER BY, SKIP and UNWIND

---
 modules/ROOT/pages/clauses/order-by.adoc | 8 ++++++++
 modules/ROOT/pages/clauses/skip.adoc     | 6 ++++++
 modules/ROOT/pages/clauses/unwind.adoc   | 6 ++++++
 3 files changed, 20 insertions(+)

diff --git a/modules/ROOT/pages/clauses/order-by.adoc b/modules/ROOT/pages/clauses/order-by.adoc
index feb5bb766..c33e49b01 100644
--- a/modules/ROOT/pages/clauses/order-by.adoc
+++ b/modules/ROOT/pages/clauses/order-by.adoc
@@ -40,12 +40,14 @@ CREATE
 `ORDER BY` is used to sort the output.
 
 .Query
+tag::clauses_order_by[]
 [source, cypher]
 ----
 MATCH (n)
 RETURN n.name, n.age
 ORDER BY n.name
 ----
+end::clauses_order_by[]
 
 The nodes are returned, sorted by their name.
 
@@ -67,12 +69,14 @@ You can order by multiple properties by stating each variable in the `ORDER BY`
 Cypher will sort the result by the first variable listed, and for equals values, go to the next property in the `ORDER BY` clause, and so on.
 
 .Query
+tag::clauses_order_by_multiple[]
 [source, cypher]
 ----
 MATCH (n)
 RETURN n.name, n.age
 ORDER BY n.age, n.name
 ----
+end::clauses_order_by_multiple[]
 
 This returns the nodes, sorted first by their age, and then by their name.
 
@@ -246,12 +250,14 @@ Read more about this capability in xref::indexes/search-performance-indexes/usin
 
 
 .Standalone use of `ORDER BY`
+tag::clauses_order_by_standalone[]
 [source, cypher]
 ----
 MATCH (n)
 ORDER BY n.name
 RETURN collect(n.name) AS names
 ----
+end::clauses_order_by_standalone[]
 
 .Result
 [role="queryresult",options="header,footer",cols="1*<m"]
@@ -264,6 +270,7 @@ RETURN collect(n.name) AS names
 The following query orders all nodes by `name` descending, skips the first row and limits the results to one row.
 
 .`ORDER BY` used in conjunction with `SKIP` and `LIMIT`
+tag::clauses_order_by_descending[]
 [source, cypher]
 ----
 MATCH (n)
@@ -272,6 +279,7 @@ SKIP 1
 LIMIT 1
 RETURN n.name AS name
 ----
+end::clauses_order_by_descending[]
 
 .Result
 [role="queryresult",options="header,footer",cols="1*<m"]
diff --git a/modules/ROOT/pages/clauses/skip.adoc b/modules/ROOT/pages/clauses/skip.adoc
index 2f31a9f49..579d44ab1 100644
--- a/modules/ROOT/pages/clauses/skip.adoc
+++ b/modules/ROOT/pages/clauses/skip.adoc
@@ -70,6 +70,7 @@ The following query returns the middle two rows, with `SKIP` skipping the first
 
 .Query
 [source, cypher]
+tag::clauses_skip[]
 ----
 MATCH (n)
 RETURN n.name
@@ -77,6 +78,7 @@ ORDER BY n.name
 SKIP 1
 LIMIT 2
 ----
+end::clauses_skip[]
 
 .Result
 [role="queryresult",options="header,footer",cols="1*<m"]
@@ -126,12 +128,14 @@ d|Rows: 4
 `SKIP` can be used as a standalone clause, or in conjunction with xref:clauses/order-by.adoc[`ORDER BY`] or xref:clauses/limit.adoc[`LIMIT`].
 
 .Standalone use of `SKIP`
+tag::clauses_skip_standalone[]
 [source, cypher]
 ----
 MATCH (n)
 SKIP 2
 RETURN collect(n.name) AS names
 ----
+end::clauses_skip_standalone[]
 
 .Result
 [role="queryresult",options="header,footer",cols="1*<m"]
@@ -169,6 +173,7 @@ RETURN collect(n.name) AS names
 `OFFSET` was introduced as part of Cypher's xref:appendix/gql-conformance/index.adoc[] and can be used as a synonym to `SKIP`.
 
 .Query
+tag::clauses_skip_offset[]
 [source, cypher]
 ----
 MATCH (n)
@@ -177,6 +182,7 @@ OFFSET 2
 LIMIT 2
 RETURN collect(n.name) AS names
 ----
+end::clauses_skip_offset[]
 
 .Result
 [role="queryresult",options="header,footer",cols="1*<m"]
diff --git a/modules/ROOT/pages/clauses/unwind.adoc b/modules/ROOT/pages/clauses/unwind.adoc
index e2c3afc4a..0526d8bcd 100644
--- a/modules/ROOT/pages/clauses/unwind.adoc
+++ b/modules/ROOT/pages/clauses/unwind.adoc
@@ -29,11 +29,13 @@ The `UNWIND` clause requires you to specify a new name for the inner values.
 We want to transform the literal list into rows named `x` and return them.
 
 .Query
+tag::clauses_unwind_list[]
 [source, cypher]
 ----
 UNWIND [1, 2, 3, null] AS x
 RETURN x, 'val' AS y
 ----
+end::clauses_unwind_list[]
 
 Each value of the original list -- including `null` -- is returned as an individual row.
 
@@ -109,6 +111,7 @@ The two lists -- _a_ and _b_ -- are concatenated to form a new list, which is th
 Multiple `UNWIND` clauses can be chained to unwind nested list elements.
 
 .Query
+tag::clauses_unwind_nested_list[]
 [source, cypher]
 ----
 WITH [[1, 2], [3, 4], 5] AS nested
@@ -116,6 +119,7 @@ UNWIND nested AS x
 UNWIND x AS y
 RETURN y
 ----
+end::clauses_unwind_nested_list[]
 
 The first `UNWIND` results in three rows for `x`, each of which contains an element of the original list (two of which are also lists); namely, `[1, 2]`, `[3, 4]`, and `5`.
 The second `UNWIND` then operates on each of these rows in turn, resulting in five rows for `y`.
@@ -212,6 +216,7 @@ Create a number of nodes and relationships from a parameter-list without using `
 ----
 
 .Query
+tag::clauses_unwind_create_nodes[]
 [source, cypher]
 ----
 UNWIND $events AS event
@@ -219,6 +224,7 @@ MERGE (y:Year {year: event.year})
 MERGE (y)<-[:IN]-(e:Event {id: event.id})
 RETURN e.id AS x ORDER BY x
 ----
+end::clauses_unwind_create_nodes[]
 
 Each value of the original list is unwound and passed through `MERGE` to find or create the nodes and relationships.
 

From d9322693d2ed1432d6da837a3b30924b41536574 Mon Sep 17 00:00:00 2001
From: Richard Sill <richard.sill@neo4j.com>
Date: Thu, 19 Dec 2024 10:06:39 +0100
Subject: [PATCH 4/9] tags for LIMIT and FOREACH

---
 modules/ROOT/pages/clauses/foreach.adoc | 2 ++
 modules/ROOT/pages/clauses/limit.adoc   | 4 ++++
 2 files changed, 6 insertions(+)

diff --git a/modules/ROOT/pages/clauses/foreach.adoc b/modules/ROOT/pages/clauses/foreach.adoc
index b594ecace..1f792bfc0 100644
--- a/modules/ROOT/pages/clauses/foreach.adoc
+++ b/modules/ROOT/pages/clauses/foreach.adoc
@@ -36,12 +36,14 @@ CREATE
 This query will set the property `marked` to `true` on all nodes along a path.
 
 .Query
+tag::clauses_foreach[]
 [source, cypher, indent=0]
 ----
 MATCH p=(start)-[*]->(finish)
 WHERE start.name = 'A' AND finish.name = 'D'
 FOREACH (n IN nodes(p) | SET n.marked = true)
 ----
+end::clauses_foreach[]
 
 .Result
 [role="queryresult",options="footer",cols="1*<m"]
diff --git a/modules/ROOT/pages/clauses/limit.adoc b/modules/ROOT/pages/clauses/limit.adoc
index cc29cf861..24870c696 100644
--- a/modules/ROOT/pages/clauses/limit.adoc
+++ b/modules/ROOT/pages/clauses/limit.adoc
@@ -166,12 +166,14 @@ Properties set: 1
 `LIMIT` can be used as a standalone clause, or in conjunction with xref:clauses/order-by.adoc[`ORDER BY`] or xref:clauses/skip.adoc[`SKIP`]/xref:clauses/skip.adoc#offset-synonym[`OFFSET`].
 
 .Standalone use of `LIMIT`
+tag::clauses_limit_standalone[]
 [source, cypher]
 ----
 MATCH (n)
 LIMIT 2
 RETURN collect(n.name) AS names
 ----
+tag::clauses_limit_standalone[]
 
 .Result
 [role="queryresult",options="header,footer",cols="1*<m"]
@@ -185,6 +187,7 @@ The following query orders all nodes by `name` descending, skips the two first r
 It then xref:functions/aggregating.adoc#functions-collect[collects] the results in a list.
 
 .`LIMIT` used in conjunction with `ORDER BY` and `SKIP`
+tag::clauses_limit[]
 [source, cypher]
 ----
 MATCH (n)
@@ -193,6 +196,7 @@ SKIP 2
 LIMIT 2
 RETURN collect(n.name) AS names
 ----
+end::clauses_limit[]
 
 .Result
 [role="queryresult",options="header,footer",cols="1*<m"]

From e49a21f50f3e4f57df540a6b281de4798e87c8a9 Mon Sep 17 00:00:00 2001
From: Richard Sill <richard.sill@neo4j.com>
Date: Fri, 20 Dec 2024 10:00:26 +0100
Subject: [PATCH 5/9] escaped tags, added tags for LOAD CSV

---
 modules/ROOT/pages/clauses/finish.adoc   |  8 ++++----
 modules/ROOT/pages/clauses/foreach.adoc  |  4 ++--
 modules/ROOT/pages/clauses/limit.adoc    |  8 ++++----
 modules/ROOT/pages/clauses/load-csv.adoc | 16 +++++++++++++++-
 modules/ROOT/pages/clauses/order-by.adoc | 16 ++++++++--------
 modules/ROOT/pages/clauses/skip.adoc     | 12 ++++++------
 modules/ROOT/pages/clauses/unwind.adoc   | 12 ++++++------
 modules/ROOT/pages/clauses/use.adoc      |  8 ++++----
 8 files changed, 49 insertions(+), 35 deletions(-)

diff --git a/modules/ROOT/pages/clauses/finish.adoc b/modules/ROOT/pages/clauses/finish.adoc
index 816ae1665..27813a216 100644
--- a/modules/ROOT/pages/clauses/finish.adoc
+++ b/modules/ROOT/pages/clauses/finish.adoc
@@ -9,24 +9,24 @@ A query ending in `FINISH` -- instead of `RETURN` -- has no result but executes
 The following read query successfully executes but has no results:
 
 .Query
-tag::clauses_finish_match[]
+// tag::clauses_finish_match[]
 [source, cypher]
 ----
 MATCH (p:Person)
 FINISH
 ----
-end::clauses_finish_match[]
+// end::clauses_finish_match[]
 
 The following query has no result but creates one node with the label `Person`:
 
 .Query
-tag::clauses_finish_create[]
+// tag::clauses_finish_create[]
 [source, cypher]
 ----
 CREATE (p:Person)
 FINISH
 ----
-end::clauses_finish_create[]
+// end::clauses_finish_create[]
 
 It is equivalent to the following query:
 
diff --git a/modules/ROOT/pages/clauses/foreach.adoc b/modules/ROOT/pages/clauses/foreach.adoc
index 1f792bfc0..b9678fb2e 100644
--- a/modules/ROOT/pages/clauses/foreach.adoc
+++ b/modules/ROOT/pages/clauses/foreach.adoc
@@ -36,14 +36,14 @@ CREATE
 This query will set the property `marked` to `true` on all nodes along a path.
 
 .Query
-tag::clauses_foreach[]
+// tag::clauses_foreach[]
 [source, cypher, indent=0]
 ----
 MATCH p=(start)-[*]->(finish)
 WHERE start.name = 'A' AND finish.name = 'D'
 FOREACH (n IN nodes(p) | SET n.marked = true)
 ----
-end::clauses_foreach[]
+// end::clauses_foreach[]
 
 .Result
 [role="queryresult",options="footer",cols="1*<m"]
diff --git a/modules/ROOT/pages/clauses/limit.adoc b/modules/ROOT/pages/clauses/limit.adoc
index 24870c696..0fee1e0ce 100644
--- a/modules/ROOT/pages/clauses/limit.adoc
+++ b/modules/ROOT/pages/clauses/limit.adoc
@@ -166,14 +166,14 @@ Properties set: 1
 `LIMIT` can be used as a standalone clause, or in conjunction with xref:clauses/order-by.adoc[`ORDER BY`] or xref:clauses/skip.adoc[`SKIP`]/xref:clauses/skip.adoc#offset-synonym[`OFFSET`].
 
 .Standalone use of `LIMIT`
-tag::clauses_limit_standalone[]
+// tag::clauses_limit_standalone[]
 [source, cypher]
 ----
 MATCH (n)
 LIMIT 2
 RETURN collect(n.name) AS names
 ----
-tag::clauses_limit_standalone[]
+// end::clauses_limit_standalone[]
 
 .Result
 [role="queryresult",options="header,footer",cols="1*<m"]
@@ -187,7 +187,7 @@ The following query orders all nodes by `name` descending, skips the two first r
 It then xref:functions/aggregating.adoc#functions-collect[collects] the results in a list.
 
 .`LIMIT` used in conjunction with `ORDER BY` and `SKIP`
-tag::clauses_limit[]
+// tag::clauses_limit[]
 [source, cypher]
 ----
 MATCH (n)
@@ -196,7 +196,7 @@ SKIP 2
 LIMIT 2
 RETURN collect(n.name) AS names
 ----
-end::clauses_limit[]
+// end::clauses_limit[]
 
 .Result
 [role="queryresult",options="header,footer",cols="1*<m"]
diff --git a/modules/ROOT/pages/clauses/load-csv.adoc b/modules/ROOT/pages/clauses/load-csv.adoc
index 6a8986945..c969a04e2 100644
--- a/modules/ROOT/pages/clauses/load-csv.adoc
+++ b/modules/ROOT/pages/clauses/load-csv.adoc
@@ -46,12 +46,14 @@ By default, paths are resolved relative to the Neo4j import directory.
 ----
 
 .Query
+// tag::clauses_load_csv_local_files[]
 [source, cypher]
 ----
 LOAD CSV FROM 'file:///artists.csv' AS row
 MERGE (a:Artist {name: row[1], year: toInteger(row[2])})
 RETURN a.name, a.year
 ----
+// end::clauses_load_csv_local_files[]
 
 .Result
 [role="queryresult",options="header,footer",cols="2*<m"]
@@ -112,12 +114,14 @@ However, this means that insecure URLs on virtual hosts will not function unless
 ----
 
 .Query
+// tag::clauses_load_csv_remote_locations[]
 [source, cypher]
 ----
 LOAD CSV FROM 'https://data.neo4j.com/bands/artists.csv' AS row
 MERGE (a:Artist {name: row[1], year: toInteger(row[2])})
 RETURN a.name, a.year
 ----
+// end::clauses_load_csv_remote_locations[]
 
 .Result
 [role="queryresult",options="header,footer",cols="2*<m"]
@@ -700,10 +704,11 @@ person_tmdbId,bio,born,bornIn,died,person_imdbId,name,person_poster,person_url
 ----
 
 [NOTE]
-The below query uses a xref:subqueries/call-subquery.adoc#variable-scope-clause[variable scope clause] (introduced in Neo4j 5.23) to import variables into the `CALL` subquery.
+The query below uses a xref:subqueries/call-subquery.adoc#variable-scope-clause[variable scope clause] (introduced in Neo4j 5.23) to import variables into the `CALL` subquery.
 If you are using an older version of Neo4j, use an xref:subqueries/call-subquery.adoc#importing-with[importing `WITH` clause] instead.
 
 .Query
+// tag::clauses_load_csv_transactions[]
 [source, cypher]
 ----
 LOAD CSV WITH HEADERS FROM 'https://data.neo4j.com/importing-cypher/persons.csv' AS row
@@ -712,6 +717,7 @@ CALL (row) {
   SET p.name = row.name, p.born = row.born
 } IN TRANSACTIONS OF 200 ROWS
 ----
+// end::clauses_load_csv_transactions[]
 
 .Result
 [source, role="queryresult"]
@@ -746,11 +752,13 @@ A common use case for this function is to generate sequential unique IDs for CSV
 ----
 
 .Query
+// tag::clauses_load_csv_linenumber[]
 [source, cypher]
 ----
 LOAD CSV FROM 'file:///artists.csv' AS row
 RETURN linenumber() AS number, row
 ----
+// end::clauses_load_csv_linenumber[]
 
 .Result
 [role="queryresult",options="header,footer",cols="2*<m"]
@@ -781,11 +789,13 @@ The xref:functions/load-csv.adoc#functions-file[`file()`] function provides the
 ----
 
 .Query
+// tag::clauses_load_csv_file[]
 [source, cypher, role=test-result-skip]
 ----
 LOAD CSV FROM 'file:///artists.csv' AS row
 RETURN DISTINCT file() AS path
 ----
+// end::clauses_load_csv_file[]
 
 .Result
 [role="queryresult",options="header,footer",cols="1*<m"]
@@ -832,6 +842,7 @@ Id,Name,Year
 ----
 
 .Query
+// tag::clauses_load_csv_headers[]
 [source, cypher]
 ----
 LOAD CSV WITH HEADERS FROM 'file:///artists-with-headers.csv' AS row
@@ -840,6 +851,7 @@ RETURN
   a.name AS name,
   a.year AS year
 ----
+// end::clauses_load_csv_headers[]
 
 .Result
 [role="queryresult",options="header,footer",cols="2*<m"]
@@ -875,11 +887,13 @@ If you try to import a file that doesn't use `,` as field delimiter and you also
 ----
 
 .Query
+// tag::clauses_load_csv_field_terminator[]
 [source, cypher]
 ----
 LOAD CSV FROM 'file:///artists-fieldterminator.csv' AS row FIELDTERMINATOR ';'
 MERGE (:Artist {name: row[1], year: toInteger(row[2])})
 ----
+// end::clauses_load_csv_field_terminator[]
 
 .Result
 [source, role="queryresult"]
diff --git a/modules/ROOT/pages/clauses/order-by.adoc b/modules/ROOT/pages/clauses/order-by.adoc
index c33e49b01..6136a5b63 100644
--- a/modules/ROOT/pages/clauses/order-by.adoc
+++ b/modules/ROOT/pages/clauses/order-by.adoc
@@ -40,14 +40,14 @@ CREATE
 `ORDER BY` is used to sort the output.
 
 .Query
-tag::clauses_order_by[]
+// tag::clauses_order_by[]
 [source, cypher]
 ----
 MATCH (n)
 RETURN n.name, n.age
 ORDER BY n.name
 ----
-end::clauses_order_by[]
+// end::clauses_order_by[]
 
 The nodes are returned, sorted by their name.
 
@@ -69,14 +69,14 @@ You can order by multiple properties by stating each variable in the `ORDER BY`
 Cypher will sort the result by the first variable listed, and for equals values, go to the next property in the `ORDER BY` clause, and so on.
 
 .Query
-tag::clauses_order_by_multiple[]
+// tag::clauses_order_by_multiple[]
 [source, cypher]
 ----
 MATCH (n)
 RETURN n.name, n.age
 ORDER BY n.age, n.name
 ----
-end::clauses_order_by_multiple[]
+// end::clauses_order_by_multiple[]
 
 This returns the nodes, sorted first by their age, and then by their name.
 
@@ -250,14 +250,14 @@ Read more about this capability in xref::indexes/search-performance-indexes/usin
 
 
 .Standalone use of `ORDER BY`
-tag::clauses_order_by_standalone[]
+// tag::clauses_order_by_standalone[]
 [source, cypher]
 ----
 MATCH (n)
 ORDER BY n.name
 RETURN collect(n.name) AS names
 ----
-end::clauses_order_by_standalone[]
+// end::clauses_order_by_standalone[]
 
 .Result
 [role="queryresult",options="header,footer",cols="1*<m"]
@@ -270,7 +270,7 @@ end::clauses_order_by_standalone[]
 The following query orders all nodes by `name` descending, skips the first row and limits the results to one row.
 
 .`ORDER BY` used in conjunction with `SKIP` and `LIMIT`
-tag::clauses_order_by_descending[]
+// tag::clauses_order_by_descending[]
 [source, cypher]
 ----
 MATCH (n)
@@ -279,7 +279,7 @@ SKIP 1
 LIMIT 1
 RETURN n.name AS name
 ----
-end::clauses_order_by_descending[]
+// end::clauses_order_by_descending[]
 
 .Result
 [role="queryresult",options="header,footer",cols="1*<m"]
diff --git a/modules/ROOT/pages/clauses/skip.adoc b/modules/ROOT/pages/clauses/skip.adoc
index 579d44ab1..47961fd50 100644
--- a/modules/ROOT/pages/clauses/skip.adoc
+++ b/modules/ROOT/pages/clauses/skip.adoc
@@ -69,8 +69,8 @@ d|Rows: 2
 The following query returns the middle two rows, with `SKIP` skipping the first and xref:clauses/limit.adoc[`LIMIT`] removing the final two.
 
 .Query
+// tag::clauses_skip[]
 [source, cypher]
-tag::clauses_skip[]
 ----
 MATCH (n)
 RETURN n.name
@@ -78,7 +78,7 @@ ORDER BY n.name
 SKIP 1
 LIMIT 2
 ----
-end::clauses_skip[]
+// end::clauses_skip[]
 
 .Result
 [role="queryresult",options="header,footer",cols="1*<m"]
@@ -128,14 +128,14 @@ d|Rows: 4
 `SKIP` can be used as a standalone clause, or in conjunction with xref:clauses/order-by.adoc[`ORDER BY`] or xref:clauses/limit.adoc[`LIMIT`].
 
 .Standalone use of `SKIP`
-tag::clauses_skip_standalone[]
+// tag::clauses_skip_standalone[]
 [source, cypher]
 ----
 MATCH (n)
 SKIP 2
 RETURN collect(n.name) AS names
 ----
-end::clauses_skip_standalone[]
+// end::clauses_skip_standalone[]
 
 .Result
 [role="queryresult",options="header,footer",cols="1*<m"]
@@ -173,7 +173,7 @@ RETURN collect(n.name) AS names
 `OFFSET` was introduced as part of Cypher's xref:appendix/gql-conformance/index.adoc[] and can be used as a synonym to `SKIP`.
 
 .Query
-tag::clauses_skip_offset[]
+// tag::clauses_skip_offset[]
 [source, cypher]
 ----
 MATCH (n)
@@ -182,7 +182,7 @@ OFFSET 2
 LIMIT 2
 RETURN collect(n.name) AS names
 ----
-end::clauses_skip_offset[]
+// end::clauses_skip_offset[]
 
 .Result
 [role="queryresult",options="header,footer",cols="1*<m"]
diff --git a/modules/ROOT/pages/clauses/unwind.adoc b/modules/ROOT/pages/clauses/unwind.adoc
index 0526d8bcd..55a739fd2 100644
--- a/modules/ROOT/pages/clauses/unwind.adoc
+++ b/modules/ROOT/pages/clauses/unwind.adoc
@@ -29,13 +29,13 @@ The `UNWIND` clause requires you to specify a new name for the inner values.
 We want to transform the literal list into rows named `x` and return them.
 
 .Query
-tag::clauses_unwind_list[]
+// tag::clauses_unwind_list[]
 [source, cypher]
 ----
 UNWIND [1, 2, 3, null] AS x
 RETURN x, 'val' AS y
 ----
-end::clauses_unwind_list[]
+// end::clauses_unwind_list[]
 
 Each value of the original list -- including `null` -- is returned as an individual row.
 
@@ -111,7 +111,7 @@ The two lists -- _a_ and _b_ -- are concatenated to form a new list, which is th
 Multiple `UNWIND` clauses can be chained to unwind nested list elements.
 
 .Query
-tag::clauses_unwind_nested_list[]
+// tag::clauses_unwind_nested_list[]
 [source, cypher]
 ----
 WITH [[1, 2], [3, 4], 5] AS nested
@@ -119,7 +119,7 @@ UNWIND nested AS x
 UNWIND x AS y
 RETURN y
 ----
-end::clauses_unwind_nested_list[]
+// end::clauses_unwind_nested_list[]
 
 The first `UNWIND` results in three rows for `x`, each of which contains an element of the original list (two of which are also lists); namely, `[1, 2]`, `[3, 4]`, and `5`.
 The second `UNWIND` then operates on each of these rows in turn, resulting in five rows for `y`.
@@ -216,7 +216,7 @@ Create a number of nodes and relationships from a parameter-list without using `
 ----
 
 .Query
-tag::clauses_unwind_create_nodes[]
+// tag::clauses_unwind_create_nodes[]
 [source, cypher]
 ----
 UNWIND $events AS event
@@ -224,7 +224,7 @@ MERGE (y:Year {year: event.year})
 MERGE (y)<-[:IN]-(e:Event {id: event.id})
 RETURN e.id AS x ORDER BY x
 ----
-end::clauses_unwind_create_nodes[]
+// end::clauses_unwind_create_nodes[]
 
 Each value of the original list is unwound and passed through `MERGE` to find or create the nodes and relationships.
 
diff --git a/modules/ROOT/pages/clauses/use.adoc b/modules/ROOT/pages/clauses/use.adoc
index a6045f548..43959819f 100644
--- a/modules/ROOT/pages/clauses/use.adoc
+++ b/modules/ROOT/pages/clauses/use.adoc
@@ -71,13 +71,13 @@ CREATE ALIAS `myComposite`.`myConstituent` FOR DATABASE `myDatabase`;
 This example assumes that the DBMS contains a database named `myDatabase`:
 
 .Query
-tag::clauses_use[]
+// tag::clauses_use[]
 [source, cypher]
 ----
 USE myDatabase
 MATCH (n) RETURN n
 ----
-end::clauses_use[]
+// end::clauses_use[]
 
 [[query-use-examples-query-composite-database-constituent-graph]]
 === Query a composite database constituent graph
@@ -85,13 +85,13 @@ end::clauses_use[]
 In this example it is assumed that the DBMS contains a composite database named `myComposite`, which includes an alias named `myConstituent`:
 
 .Query
-tag::clauses_use_composite[]
+// tag::clauses_use_composite[]
 [source, cypher]
 ----
 USE myComposite.myConstituent
 MATCH (n) RETURN n
 ----
-end::clauses_use_composite[]
+// end::clauses_use_composite[]
 
 
 [[query-use-examples-query-composite-database-constituent-graph-dynamically]]

From 469c1b688c9ac2ac3ff174435e23da363c4cb68a Mon Sep 17 00:00:00 2001
From: Richard Sill <richard.sill@neo4j.com>
Date: Wed, 8 Jan 2025 11:43:23 +0100
Subject: [PATCH 6/9] added two examples to the FOREACH page

---
 modules/ROOT/pages/clauses/foreach.adoc | 41 +++++++++++++++++++++++--
 1 file changed, 38 insertions(+), 3 deletions(-)

diff --git a/modules/ROOT/pages/clauses/foreach.adoc b/modules/ROOT/pages/clauses/foreach.adoc
index b9678fb2e..1f595a1cb 100644
--- a/modules/ROOT/pages/clauses/foreach.adoc
+++ b/modules/ROOT/pages/clauses/foreach.adoc
@@ -33,17 +33,17 @@ CREATE
 [[foreach-mark-all-nodes-along-a-path]]
 == Mark all nodes along a path
 
-This query will set the property `marked` to `true` on all nodes along a path.
+This query sets the property `marked` to `true` on all nodes along a path.
 
 .Query
-// tag::clauses_foreach[]
+// tag::clauses_foreach_node[]
 [source, cypher, indent=0]
 ----
 MATCH p=(start)-[*]->(finish)
 WHERE start.name = 'A' AND finish.name = 'D'
 FOREACH (n IN nodes(p) | SET n.marked = true)
 ----
-// end::clauses_foreach[]
+// end::clauses_foreach_node[]
 
 .Result
 [role="queryresult",options="footer",cols="1*<m"]
@@ -53,3 +53,38 @@ d|Rows: 0 +
 Properties set: 4
 |===
 
+
+== Mark all relationships along a path
+
+This query sets the property `marked` to `true` on all relationships along a path.
+
+// tag::clauses_foreach_relationship[]
+[source, cypher, indent=0, role=test-skip]
+----
+MATCH p=(start)-[*]->(finish)
+WHERE start.name = 'A' AND finish.name = 'D'
+FOREACH ( r IN relationships(p) | SET r.marked = true )
+----
+// end::clauses_foreach_relationship[]
+
+.Result
+[role="queryresult",options="footer",cols="1*<m"]
+|===
+|(empty result)
+d|Rows: 0 +
+Properties set: 4
+|===
+
+
+== Create new nodes from a list of name labels
+
+This query creates a new node for each label in a list.
+
+.Query
+// tag::clauses_foreach_create[]
+[source, cypher, indent=0 role=test-skip]
+----
+WITH ['E', 'F', 'G'] AS names
+FOREACH ( value IN names | CREATE (:Person {name: value}) )
+----
+// end::clauses_foreach_create[]
\ No newline at end of file

From 111deaaefc8e074ffcbe0cf2b38e6ed1c5618aae Mon Sep 17 00:00:00 2001
From: Richard Sill <richard.sill@neo4j.com>
Date: Wed, 8 Jan 2025 13:03:16 +0100
Subject: [PATCH 7/9] added custom section anchors and result listings

---
 modules/ROOT/pages/clauses/foreach.adoc | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

diff --git a/modules/ROOT/pages/clauses/foreach.adoc b/modules/ROOT/pages/clauses/foreach.adoc
index 1f595a1cb..237ea086a 100644
--- a/modules/ROOT/pages/clauses/foreach.adoc
+++ b/modules/ROOT/pages/clauses/foreach.adoc
@@ -54,6 +54,7 @@ Properties set: 4
 |===
 
 
+[[foreach-mark-all-relationships-along-a-path]]
 == Mark all relationships along a path
 
 This query sets the property `marked` to `true` on all relationships along a path.
@@ -72,10 +73,10 @@ FOREACH ( r IN relationships(p) | SET r.marked = true )
 |===
 |(empty result)
 d|Rows: 0 +
-Properties set: 4
+Properties set: 3
 |===
 
-
+[[foreach-create-new-nodes-form-a-list]]
 == Create new nodes from a list of name labels
 
 This query creates a new node for each label in a list.
@@ -87,4 +88,12 @@ This query creates a new node for each label in a list.
 WITH ['E', 'F', 'G'] AS names
 FOREACH ( value IN names | CREATE (:Person {name: value}) )
 ----
-// end::clauses_foreach_create[]
\ No newline at end of file
+// end::clauses_foreach_create[]
+
+.Result
+[role="queryresult",options="footer",cols="1*<m"]
+|===
+1+|(empty result)
+1+d|Rows: 0 +
+Nodes created: 3
+|===
\ No newline at end of file

From d780a4a2e863b12cc929e1872456ff51dd916273 Mon Sep 17 00:00:00 2001
From: Richard Sill <156673635+rsill-neo4j@users.noreply.github.com>
Date: Tue, 14 Jan 2025 09:31:43 +0100
Subject: [PATCH 8/9] Apply suggestions from code review

---
 modules/ROOT/pages/clauses/foreach.adoc | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/modules/ROOT/pages/clauses/foreach.adoc b/modules/ROOT/pages/clauses/foreach.adoc
index 237ea086a..2132954e6 100644
--- a/modules/ROOT/pages/clauses/foreach.adoc
+++ b/modules/ROOT/pages/clauses/foreach.adoc
@@ -60,7 +60,7 @@ Properties set: 4
 This query sets the property `marked` to `true` on all relationships along a path.
 
 // tag::clauses_foreach_relationship[]
-[source, cypher, indent=0, role=test-skip]
+[source, cypher, indent=0]
 ----
 MATCH p=(start)-[*]->(finish)
 WHERE start.name = 'A' AND finish.name = 'D'
@@ -83,7 +83,7 @@ This query creates a new node for each label in a list.
 
 .Query
 // tag::clauses_foreach_create[]
-[source, cypher, indent=0 role=test-skip]
+[source, cypher, indent=0]
 ----
 WITH ['E', 'F', 'G'] AS names
 FOREACH ( value IN names | CREATE (:Person {name: value}) )

From 385cfeb94b48111a91577ab45f822344f688db75 Mon Sep 17 00:00:00 2001
From: Richard Sill <156673635+rsill-neo4j@users.noreply.github.com>
Date: Tue, 14 Jan 2025 11:11:38 +0100
Subject: [PATCH 9/9] Apply suggestions from code review

---
 modules/ROOT/pages/clauses/finish.adoc | 2 --
 1 file changed, 2 deletions(-)

diff --git a/modules/ROOT/pages/clauses/finish.adoc b/modules/ROOT/pages/clauses/finish.adoc
index 27813a216..2d3315e13 100644
--- a/modules/ROOT/pages/clauses/finish.adoc
+++ b/modules/ROOT/pages/clauses/finish.adoc
@@ -20,13 +20,11 @@ FINISH
 The following query has no result but creates one node with the label `Person`:
 
 .Query
-// tag::clauses_finish_create[]
 [source, cypher]
 ----
 CREATE (p:Person)
 FINISH
 ----
-// end::clauses_finish_create[]
 
 It is equivalent to the following query: