review suggestions

Author: rsill-neo4j

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

@@ -19,22 +19,22 @@ See also xref::values-and-types/temporal.adoc[Temporal values] and xref::express
 | *Syntax* 3+| `duration(input[, pattern])`
 | *Description* 3+| Creates a `DURATION` value.
 .3+| *Arguments* | *Name* | *Type* | *Description*
-| `input` | `ANY` | A map optionally containing the following keys: 'years', 'months', 'weeks', 'days', 'hours', 'minutes', 'seconds', 'milliseconds', 'microseconds', or 'nanoseconds'.
+| `input` | `ANY` | Either a string representation of a duration value or a map optionally containing the following keys: 'years', 'months', 'weeks', 'days', 'hours', 'minutes', 'seconds', 'milliseconds', 'microseconds', or 'nanoseconds'.
 | `pattern` | `STRING` | A pattern used to parse the input. If a pattern is provided, `input` must be `STRING`.
 | *Returns* 3+| `DURATION`
 |===
 
 .Considerations
 |===
 
-| At least one parameter must be provided (`duration()` and `+duration({})+` are invalid).
-| There is no constraint on how many of the parameters are provided.
+| If `input` is not a string, at least one component must be provided (`duration()` and `+duration({})+` are invalid).
+| There is no constraint on how many components are provided.
 | It is possible to have a `DURATION` where the amount of a smaller unit (e.g. `seconds`) exceeds the threshold of a larger unit (e.g. `days`).
-| The values of the parameters may be expressed as decimal fractions.
-| The values of the parameters may be arbitrarily large.
-| The values of the parameters may be negative.
+| The values of the components may be expressed as decimal fractions.
+| The values of components may be arbitrarily large.
+| The values of components may be negative.
 | The xref:values-and-types/temporal.adoc#cypher-temporal-accessing-components-durations[components of `DURATION` objects] are individually accessible.
-| The `pattern` parameter is constructed from xref:functions/temporal/format.adoc#query-functions-temporal-format-duration-types-characters[Allowed characters for duration types].
+| The `pattern` argument is constructed from xref:functions/temporal/format.adoc#query-functions-temporal-format-duration-types-characters[Allowed characters for duration types].
 
 |===
 
@@ -132,7 +132,6 @@ RETURN aDuration
 | If `from` has a time component and `to` does not, the time component of `to` is assumed to be midnight, and vice versa.
 | If `from` has a time zone component and `to` does not, the time zone component of `to` is assumed to be the same as that of `from`, and vice versa.
 | If `to` has a date component and `from` does not, the date component of `from` is assumed to be the same as that of `to`, and vice versa.
-| 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].
 
 |===
 

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

@@ -395,7 +395,7 @@ The following table lists the supported truncation units and the corresponding s
 | `date(null)` returns `null`.
 | If any of the optional parameters are provided, these will override the corresponding components of `date`.
 | `date(dd)` may be written instead of `+date({date: dd})+`.
-| The `pattern` parameter is constructed from xref:functions/temporal/format.adoc#query-functions-temporal-format-instance-types-characters[Allowed characters for instance types].
+| The `pattern` argument is constructed from xref:functions/temporal/format.adoc#query-functions-temporal-format-instance-types-characters[Allowed characters for instance types].
 
 |===
 
@@ -920,7 +920,7 @@ RETURN
 | Selecting a `ZONED DATETIME` or `ZONED TIME` as the `time` component and overwriting the timezone will adjust the local time to keep the same point in time.
 | `epochSeconds`/`epochMillis` may be used in conjunction with `nanosecond`.
 | `datetime(null)` returns null.
-| The `pattern` parameter is constructed from xref:functions/temporal/format.adoc#query-functions-temporal-format-instance-types-characters[Allowed characters for instance types].
+| The `pattern` argument is constructed from xref:functions/temporal/format.adoc#query-functions-temporal-format-instance-types-characters[Allowed characters for instance types].
 
 |===
 
@@ -1671,7 +1671,7 @@ RETURN
 | `localdatetime(null)` returns null.
 | If any of the optional parameters are provided, these will override the corresponding components of `datetime`, `date` and/or `time`.
 | `localdatetime(dd)` may be written instead of `+localdatetime({datetime: dd})+`.
-| The `pattern` parameter is constructed from xref:functions/temporal/format.adoc#query-functions-temporal-format-instance-types-characters[Allowed characters for instance types].
+| The `pattern` argument is constructed from xref:functions/temporal/format.adoc#query-functions-temporal-format-instance-types-characters[Allowed characters for instance types].
 
 |===
 
@@ -2241,7 +2241,7 @@ RETURN
 | `localtime(null)` returns null.
 | If any of the optional parameters are provided, these will override the corresponding components of `time`.
 | `localtime(tt)` may be written instead of `localtime({time: tt})`.
-| The `pattern` parameter is constructed from xref:functions/temporal/format.adoc#query-functions-temporal-format-instance-types-characters[Allowed characters for instance types].
+| The `pattern` argument is constructed from xref:functions/temporal/format.adoc#query-functions-temporal-format-instance-types-characters[Allowed characters for instance types].
 
 |===
 
@@ -2647,7 +2647,7 @@ RETURN
 | `time(tt)` may be written instead of `+time({time: tt})+`.
 | Selecting a `ZONED TIME` or `ZONED DATETIME` value as the `time` component also selects its timezone. If a `LOCAL TIME` or `LOCAL DATETIME` is selected instead, the default timezone is used. In any case, the timezone can be overridden explicitly.
 | Selecting a `ZONED DATETIME` or `ZONED TIME` as the `time` component and overwriting the timezone will adjust the local time to keep the same point in time.
-| The `pattern` parameter is constructed from xref:functions/temporal/format.adoc#query-functions-temporal-format-instance-types-characters[Allowed characters for instance types].
+| The `pattern` argument is constructed from xref:functions/temporal/format.adoc#query-functions-temporal-format-instance-types-characters[Allowed characters for instance types].
 
 |===