Final Expressions (#1243)

This PR does the following:

- Removes the old Expressions overview page (outdated).
- Creates 2 new pages from its obliteration
(values-and-types/numeric-string-boolean.adoc and
values-and-types/graph-references)
- Redirects any remaining links to the old Syntax/operators page (gone)
and Expressions overview page

Author: JPryce-Aklundh

modules/ROOT/content-nav.adoc

@@ -55,17 +55,18 @@
 ** 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[]
@@ -135,7 +136,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[]

modules/ROOT/pages/appendix/gql-conformance/additional-cypher.adoc

@@ -620,7 +620,7 @@ GQL supports `GRAPH TYPES` as a way of constraining a graph schema, but does not
 | Cypher feature
 | Description
 
-| xref:syntax/operators.adoc#query-operator-comparison-string-specific[`STARTS WITH`, `CONTAINS`, `ENDS WITH`, and regular expressions].
+| xref:expressions/predicates/string-operators.adoc[`STARTS WITH`, `CONTAINS`, `ENDS WITH`, and regular expressions].
 | `STRING` comparison operators.
 
 | xref:expressions/predicates/list-operators.adoc[`IN`]

modules/ROOT/pages/appendix/gql-conformance/supported-mandatory.adoc

@@ -132,7 +132,7 @@ The only way to guarantee row order in Neo4j is to use xref:clauses/order-by.ado
 
 | 19.3
 | <comparison predicate>
-| xref:syntax/operators.adoc##query-operators-comparison[Comparison operators]
+| xref:expressions/predicates/comparison-operators.adoc[Comparison operators]
 |
 
 | 19.4
@@ -152,12 +152,12 @@ The only way to guarantee row order in Neo4j is to use xref:clauses/order-by.ado
 
 | 19.7
 | <normalized predicate>
-| xref:syntax/operators.adoc#match-string-is-normalized[`IS NORMALIZED`], xref:syntax/operators.adoc#match-string-is-not-normalized[`IS NOT NORMALIZED`]
+| xref:expressions/predicates/string-operators.adoc#string-normalization-operators[`IS NORMALIZED`,`IS NOT NORMALIZED`]
 |
 
 | 20.2
 | <value expression primary>
-| xref:expressions/expressions-overview.adoc[]
+| xref:expressions/index.adoc[]
 |
 
 | 20.3
@@ -194,7 +194,7 @@ For example, `RETURN sum(<expr>)` on an empty table returns `NULL` in GQL, but i
 
 | 20.23
 | <string value expression>
-| xref:syntax/operators.adoc#syntax-concatenating-two-strings-doublebar[`STRING` concatenation operator (`\|\|`)]
+| xref:expressions/string-operators.adoc[`STRING` concatenation operator (`\|\|`)]
 |
 
 | 20.24

modules/ROOT/pages/appendix/gql-conformance/supported-optional.adoc

@@ -128,7 +128,7 @@ Cypher only supports xref:functions/mathematical-numeric.adoc#functions-ceil[`ce
 | Note the following exceptions:
 
  * Cypher uses the xref:functions/mathematical-logarithmic.adoc#functions-log[`log()`] function instead of GQL's `LN()` function.
-* Cypher uses the xref:syntax/operators.adoc#syntax-using-the-exponentiation-operator[exponentiation operator (`^`)] instead of GQL's `POWER()` function.
+* Cypher uses the xref:expressions/mathematical-operators.adoc[exponentiation operator (`^`)] instead of GQL's `POWER()` function.
 
 | GF05
 | Multi-character trim functions

modules/ROOT/pages/clauses/match.adoc

@@ -387,7 +387,7 @@ RETURN p.name AS actor, r.role AS role
 ----
 
 [NOTE]
-The above query uses the xref:syntax/operators.adoc#query-operator-comparison-string-specific[`CONTAINS` operator].
+The above query uses the xref:expressions/predicates/string-operators.adoc[`CONTAINS` operator].
 
 .Result
 [role="queryresult",options="header,footer",cols="2*<m"]

modules/ROOT/pages/clauses/order-by.adoc

@@ -6,7 +6,7 @@
 `ORDER BY` specifies how the output of a clause should be sorted.
 It be used as a sub-clause following `RETURN` or `WITH`.
 
-`ORDER BY` relies on comparisons to sort the output, see xref::syntax/operators.adoc#cypher-ordering[Ordering and comparison of values].
+`ORDER BY` relies on comparisons to sort the output, see xref:values-and-types/ordering-equality-comparison.adoc[Ordering and comparison of values].
 You can sort on many different values, e.g. node/relationship properties, the node/relationship ids, or on most expressions.
 
 [NOTE]

modules/ROOT/pages/clauses/use.adoc

@@ -25,7 +25,7 @@ When connected to a composite database, a graph reference may additionally be pa
 
 * The graph function xref:functions/graph.adoc#functions-graph-byname[`graph.byName()`], which allows the graph reference to be resolved dynamically: `USE graph.byName(<string-expression>)`.
 
-A more detailed description of how and when a graph references needs to be quoted and/or escaped is defined xref::expressions/expressions-overview.adoc#graphreferences[here].
+A more detailed description of how and when a graph references needs to be quoted and/or escaped is defined xref::values-and-types/graph-references.adoc#rules[here].
 
 == USE clause when connected to a standard or system database
 

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

@@ -178,7 +178,7 @@ USE graph.byName('tom`s-database')
 
 USE graph.propertiesByName('database.with.dot')
 ----
-|  xref::expressions/expressions-overview.adoc#graphreferences[Graph references] in arguments of the functions xref:functions/graph.adoc#functions-graph-byname[`graph.byName`] and xref:functions/graph.adoc#functions-graph-propertiesByName[`graph.propertiesByName`] in Cypher 25 are parsed as `<symbolic-name>` or `<symbolic-name>.<symbolic-name>` and now support escaping names.
+|  xref::values-and-types/graph-references.adoc[Graph references] in arguments of the functions xref:functions/graph.adoc#functions-graph-byname[`graph.byName`] and xref:functions/graph.adoc#functions-graph-propertiesByName[`graph.propertiesByName`] in Cypher 25 are parsed as `<symbolic-name>` or `<symbolic-name>.<symbolic-name>` and now support escaping names.
 For more information, see xref:syntax/expressions.adoc#graph-references[Cypher expressions -> Graph references].
 Graph name parts that contain unsupported characters for unescaped symbolic names now require backtick quoting.
 Graph name parts with special characters may require additional escaping of those characters:
@@ -1167,7 +1167,7 @@ RETURN "Hello" \|\| " " \|\| "World";
 
 RETURN [1, 2] \|\| [3, 4, 5];
 ----
-| Added a new `STRING` and `LIST` xref:syntax/operators.adoc[concatenation operator].
+| Added a new `STRING` and `LIST` xref:expressions/string-operators.adoc[concatenation operator].
 
 a|
 label:functionality[]
@@ -1368,7 +1368,7 @@ IS [NOT] [NFC \| NFD \| NFKC \| NFKD] NORMALIZED
 RETURN "string" IS NORMALIZED
 ----
 
-| Introduction of an xref::syntax/operators.adoc#match-string-is-normalized[IS NORMALIZED] operator.
+| Introduction of an xref::expressions/predicates/string-operators.adoc#string-normalization-operator[IS NORMALIZED] operator.
 The operator can be used to check if a `STRING` is normalized according to the specified normalization form, which can be of type `NFC`, `NFD`, `NFKC`, or `NFKD`.
 
 a|

modules/ROOT/pages/expressions/conditional-expressions.adoc

@@ -106,11 +106,12 @@ implied equals (`=`) comparator.
 
 The supported comparators are:
 
-* xref::syntax/operators.adoc#query-operators-comparison[Regular Comparison Operators]: `+=+`, `+<>+`, `+<+`, `+>+`, `+<=+`, `+>=+`
-* xref:values-and-types/working-with-null.adoc#is-null-is-not-null[`IS NULL` Operator]: `IS [NOT] NULL`
-* xref:expressions/predicates/type-predicate-expressions.adoc[Type Predicate Expression]: `IS [NOT] TYPED <TYPE>` (Note that the form `IS [NOT] :: <TYPE>` is not accepted)
-* xref::syntax/operators.adoc#match-string-is-normalized[Normalization Predicate Expression]: `IS [NOT] NORMALIZED`
-* xref::syntax/operators.adoc#query-operator-comparison-string-specific[String Comparison Operators]: `STARTS WITH`, `ENDS WITH`, `=~` (regex matching)
+* xref:expressions/predicates/comparison-operators.adoc[Regular Comparison Operators]: `+=+`, `+<>+`, `+<+`, `+>+`, `+<=+`, `+>=+`
+* xref:expressions/predicates/comparison-operators.adoc[`IS [NOT] NULL`]
+* xref:expressions/predicates/type-predicate-expressions.adoc[Type predicate expressions]: `IS [NOT] TYPED <TYPE>` (Note that the form `IS [NOT] :: <TYPE>` is not accepted)
+* xref:expressions/predicates/string-operators.adoc[Normalization Predicate Expression]: `IS [NOT] NORMALIZED`
+* xref:expressions/predicates/string-operators.adoc[String Comparison Operators]: `STARTS WITH`, `ENDS WITH`, `=~` (regex matching)
+
 
 === Syntax