PR review updates

Author: gem-neo4j

modules/ROOT/pages/functions/list.adoc

@@ -58,12 +58,12 @@ CREATE
 ======
 
 .Deduplicate a list of integer values
-// tag::functions_list_distinct[]
+// tag::functions_list_distinct_ints[]
 [source, cypher]
 ----
 RETURN coll.distinct([1, 3, 2, 4, 2, 3, 1])
 ----
-// end::functions_list_distinct[]
+// end::functions_list_distinct_ints[]
 
 A `LIST<ANY>` containing only unique values is returned.
 
@@ -77,12 +77,12 @@ A `LIST<ANY>` containing only unique values is returned.
 |===
 
 .Deduplicate a list of mixed values, including null
-// tag::functions_list_distinct[]
+// tag::functions_list_distinct_mixed[]
 [source, cypher]
 ----
 RETURN coll.distinct([1, true, true, null, 'a', false, true, 1, null])
 ----
-// end::functions_list_distinct[]
+// end::functions_list_distinct_mixed[]
 
 A `LIST<ANY>` containing only unique values is returned.
 
@@ -146,12 +146,12 @@ A `LIST<ANY>` with any inner lists up to a nesting depth of 2 flattened.
 |===
 
 .Flatten a list to default of depth 1
-// tag::functions_list_flatten[]
+// tag::functions_list_flatten_default[]
 [source, cypher]
 ----
 RETURN coll.flatten(['a', ['b', ['c']]])
 ----
-// end::functions_list_flatten[]
+// end::functions_list_flatten_default[]
 
 A `LIST<ANY>` with any inner lists up to a nesting depth of 1 (default depth) flattened.
 
@@ -213,12 +213,12 @@ An `INTEGER` representing the index of the item in the list.
 |===
 
 .Search for a value not present in the given list
-// tag::functions_list_indexOf[]
+// tag::functions_list_indexOf_missing[]
 [source, cypher]
 ----
 RETURN coll.indexOf([1, 'b', false], 4.3)
 ----
-// end::functions_list_indexOf[]
+// end::functions_list_indexOf_missing[]
 
 The `INTEGER` -1 representing that the value is not found.
 
@@ -268,7 +268,7 @@ RETURN coll.insert([true, 'a', 1, 5.4], 1, false)
 ----
 // end::functions_list_insert[]
 
-The original list with a new value inserted at the given index. 
+The original list with a new value inserted at the given index, shifting all the values following by 1.
 
 .Result
 [role="queryresult",options="header,footer",cols="1*<m"]