review suggestions

Author: rsill-neo4j

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

@@ -542,6 +542,20 @@ If the points are in a Cartesian CRS, the function returns the Euclidean distanc
 |===
 
 
+[[temporal-format-functions]]
+=== Temporal format functions
+
+[options="header", cols="2a,5a"]
+|===
+| Cypher feature
+| Description
+
+| xref:functions/temporal/format.adoc[`format()`]
+| Returns the temporal value as an ISO-formatted `STRING` or as a `STRING` formatted by the provided pattern.
+
+|===
+
+
 [[vector-functions]]
 === Vector functions
 

modules/ROOT/pages/functions/temporal/format.adoc

@@ -8,9 +8,6 @@
 == format()
 
 The `format()` function creates dynamically formatted string representations of temporal instance and duration types.
-The output format can be customized via the `pattern` parameter.
-The `pattern` parameter follows the link:https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/time/format/DateTimeFormatter.html[Java DateTimeFormatter].
-If no pattern is specified, the function returns an ISO-formatted string.
 
 .Details
 |===
@@ -22,6 +19,16 @@ If no pattern is specified, the function returns an ISO-formatted string.
 | *Returns*        3+| `STRING`
 |===
 
+.Considerations
+|===
+| The output format can be customized via the `pattern` parameter.
+| The `pattern` parameter follows the link:https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/time/format/DateTimeFormatter.html[Java DateTimeFormatter].
+| If no pattern is specified, the function returns an ISO-formatted string.
+| Most characters yield a different output when they are repeated.
+| Some characters cannot be applied to certain types, for instance, `u` cannot be used to construct a string for a `LOCAL TIME` because it represents a year which is not part of the temporal value.
+| Any character that is not reserved, other than `[`, `]`, `{`, `}`, `#`, and `'`, are output directly. To ensure future compatibility it is recommended to wrap all characters that you want to output directly with single quotes.
+|===
+
 [[query-functions-temporal-format-instance-types]]
 == Instance types
 
@@ -219,14 +226,6 @@ The three occurrences of `p` add one space character of padding to the two digit
 | `'`       | single quote               | literal      | 
 |===
 
-.Considerations
-|===
-| Most characters yield a different output when they are repeated.
-| Some characters cannot be applied to certain types, for instance, `u` cannot be used to construct a string for a `LOCAL TIME` because it represents a year which is not part of the temporal value.
-| For details, refer to the documentation of the link:https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/time/format/DateTimeFormatter.html[Java DateTimeFormatter].
-| Any character that is not reserved, other than `[`, `]`, `{`, `}`, `#`, and `'`, are output directly. To ensure future compatibility it is recommended to wrap all characters that you want to output directly with single quotes.
-|===
-
 
 [[query-functions-temporal-format-duration-types]]
 == Duration types
@@ -288,27 +287,28 @@ RETURN format(d, "w 'weeks' d 'days'") AS withWeeks, format(d, "d 'days'") AS wi
 
 ======
 
-.Duration formatting with hours converted to minutes
+.Duration formatting, hours converted to minutes
 ======
 
 .Query
 [source, cypher, indent=0]
 ----
 WITH duration({days: 4, hours: 5, minutes: 6, seconds: 7}) AS d
-RETURN format(d, "m 'minutes' s 'seconds'") AS withMinutes, format(d, "s 'seconds'") AS withoutMinutes 
+RETURN format(d, "h 'hours' m 'minutes'") AS withHours, format(d, "m 'minutes'") AS withoutHours
 ----
 
 .Result
 [role="queryresult",options="header,footer",cols="2*<m"]
 |===
 
-| withMinutes             | withoutMinutes
-| "306 minutes 7 seconds" | "18367 seconds"
+| withHours             | withoutHours
+| "5 hours 6 minutes"   | "306 minutes"
 2+d|Rows: 1
 
 |===
 
-Note how the days cannot be converted to hours and do not affect the query result.
+Note how the four days cannot be converted to hours or minutes and do not affect the query result.
+Days are in a different component group than hours and minutes, see xref:#duration-character-table[].
 
 ======