Apply suggestions from code review

Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>

Author: sanderson

content/shared/sql-reference/functions/array.md

@@ -336,7 +336,7 @@ _Alias of [empty](#empty)._
 
 ## array_except
 
-Returns an array of elements that appear in the first array but not in the second.
+Returns an array containing elements from the first array that are not present in the second array.
 
 ```sql
 array_except(array1, array2)
@@ -441,7 +441,7 @@ SELECT array_has_all([1, 2, 3, 4], [2, 3]) AS array_has_all
 
 ## array_has_any
 
-Returns `true` if any elements exist in both arrays.
+Returns `true` if at least one element appears in both arrays.
 
 ```sql
 array_has_any(array, sub-array)
@@ -479,7 +479,7 @@ _Alias of [array_position](#array_position)._
 
 ## array_intersect
 
-Returns an array of elements in the intersection of **array1** and **array2**.
+Returns an array containing only the elements that appear in both **array1** and **array2**.
 
 ```sql
 array_intersect(array1, array2)
@@ -1107,7 +1107,8 @@ SELECT array_replace_n(['John', 'Jane', 'James', 'John', 'John'], 'John', 'Joe',
 ## array_resize
 
 Resizes the list to contain size elements. Initializes new elements with value
-or empty if value is not set.
+Resizes the array to the specified size. If expanding, fills new elements with the
+specified value (or _NULL_ if not provided). If shrinking, truncates excess elements.
 
 ```sql
 array_resize(array, size, value)
@@ -1269,7 +1270,7 @@ SELECT
 
 ## array_to_string
 
-Converts an array to string-based representation with a specified delimiter.
+Converts an array to a string by joining all elements with the specified delimiter.
 
 ```sql
 array_to_string(array, delimiter[, null_string])
@@ -1318,7 +1319,8 @@ SELECT array_to_string([[1,2,3,4,5,NULL,7,8,NULL]], '-', '?') AS array_to_string
 ## array_union
 
 Returns an array of elements that are present in both arrays (all elements from
-both arrays) with out duplicates.
+Returns an array containing all unique elements from both input arrays, with
+duplicates removed.
 
 ```sql
 array_union(array1, array2)
@@ -1414,12 +1416,12 @@ SELECT empty(['apple']) AS empty
 
 ## flatten
 
-Converts an array of arrays to a flat array.
+Flattens nested arrays into a single-level array.
 
-- Applies to any depth of nested arrays
-- Does not change arrays that are already flat
+- Recursively flattens arrays at any depth of nesting
+- Returns unchanged if the array is already flat
 
-The flattened array contains all the elements from all source arrays.
+The result contains all elements from all nested arrays in a single flat array.
 
 ```sql
 flatten(array)

content/shared/sql-reference/functions/map.md

@@ -15,7 +15,7 @@ _Alias of [map_extract](#map_extract)._
 
 ## make_map
 
-Returns an Arrow map with the specified key-value pair.
+Returns an Arrow map with the specified key and value.
 
 ```sql
 make_map(key, value)
@@ -62,6 +62,8 @@ Each _key_ must be unique and non-null.
 
 ```sql
 map(key_list, value_list)
+-- or
+map { key: value, ... }
 ```
 
 ### Arguments
@@ -142,7 +144,9 @@ SELECT
 ## map_extract
 
 Returns a list containing the value for the given key or an empty list if the
-key is not present in the map.
+Returns a list containing the value for the given key, or an empty list if the
+key is not present in the map. The returned list will contain exactly one element
+(the value) when the key is found.
 
 ```sql
 map_extract(map, key)
@@ -176,9 +180,9 @@ to perform the a query that:
 - Queries the weather sample data and use `date_part` to extract an integer
   representing the day of the week of the row's `time` value.
 - Uses `map_extract` and the output of `date_part` to return an array containing
-  the name of the data of the week.
+  the name of the day of the week.
 - Uses bracket notation (`[i]`) to reference an element by index in the returned
-  list (lists are 1-indexed).
+  list (SQL arrays are 1-indexed, so `[1]` retrieves the first element).
 
 ```sql
 WITH constants AS (

content/shared/sql-reference/functions/struct.md

@@ -58,7 +58,8 @@ _Alias of [`struct`](#struct)._
 
 Returns an _Arrow struct_ using the specified input expressions optionally named.
 Fields in the returned struct use the optional name or the `cN` naming convention.
-For example: `c0`, `c1`, `c2`, etc.
+Fields in the returned struct use the `cN` naming convention (for example: `c0`, `c1`, `c2`, etc.) 
+unless you specify custom names using the `AS` operator within individual expressions.
 
 ```sql
 struct(expression1[, ..., expression_n])
@@ -67,7 +68,7 @@ struct(expression1[, ..., expression_n])
 ### Arguments
 
 - **expression1, expression_n**: Expression to include in the output struct.
-  Can be a constant, column, or function, any combination of arithmetic or
+  Can be a constant, column, or function, and any combination of arithmetic or
   string operators.
 
 ### Aliases
@@ -86,7 +87,7 @@ _The following example uses the
 
 ```sql
 SELECT
-  struct('time', time, 'temperature', temp, 'humidity', hum) AS struct
+  struct(time, temp, hum) AS struct
 FROM
   home
 WHERE