Resolve remarks Mikey

Author: Gijsreyn

docs/reference/schemas/config/functions/coalesce.md

@@ -20,7 +20,7 @@ coalesce(<value1>, <value2>, ...)
 ## Description
 
 The `coalesce()` function evaluates arguments from left to right and returns the first argument that
-is not null. This function is useful for providing fallback values when dealing with potentially
+isn't null. This function is useful for providing fallback values when dealing with potentially
 null data.
 
 If all arguments are null, the function returns null.
@@ -41,7 +41,7 @@ resources:
     output: 
       firstNonNull:     "[coalesce(null(), 'DSC', 'landscape')]"
       allNull:          "[coalesce(null(), null(), null())]"
-      firstNotNull:     "[coalesce('first', 'second', 'third')]"
+      noneNull:     "[coalesce('first', 'second', 'third')]"
 ```
 
 ```bash
@@ -57,7 +57,7 @@ results:
       output:
         firstNonNull: DSC
         allNull: null
-        firstNotNull: first
+        noneNull: first
 messages: []
 hadErrors: false
 ```

docs/reference/schemas/config/functions/createObject.md

@@ -110,7 +110,7 @@ resources:
   properties:
     output:
       nestedObject:   "[createObject('config', createObject('timeout', 30, 'enabled', true))]"
-      objectWithArray: "[createObject('items', createArray('Yoda', 'Darth Vader', 'Palpetine'))]"
+      objectWithArray: "[createObject('items', createArray('foo', 'bar', 'baz'))]"
 ```
 
 ```bash
@@ -130,9 +130,9 @@ results:
             enabled: true
         objectWithArray:
           items:
-          - Yoda
-          - 'Darth Vader'
-          - Palpetine
+          - foo
+          - bar
+          - baz
 messages: []
 hadErrors: false
 ```
@@ -180,7 +180,7 @@ hadErrors: false
 
 ## Parameters
 
-### key, value pairs
+### Key-value pairs
 
 The `createObject()` function accepts zero or more key-value pairs. Each key must be a string,
 and values can be of any type.
@@ -228,11 +228,11 @@ The function will return an error in the following cases:
 
 ## Notes
 
-- Keys must be strings; numeric or other types are not allowed as keys
-- Values can be any valid JSON type including null, arrays, and nested objects
-- Duplicate keys will result in the last value overwriting previous values
-- Empty object creation (`createObject()` with no arguments) is supported
-- The function preserves the order of properties as specified
+- Keys must be strings. If you specify numeric or other types, DSC raises an error.
+- Values can be any valid JSON type including null, arrays, and nested objects.
+- Duplicate keys will result in the last value overwriting previous values.
+- Empty object creation (`createObject()` with no arguments) is supported.
+- The function preserves the order of properties as specified.
 
 ## Related functions
 

docs/reference/schemas/config/functions/null.md

@@ -123,17 +123,6 @@ messages: []
 hadErrors: false
 ```
 
-## Parameters
-
-The `null()` function accepts no parameters.
-
-```yaml
-Type:         none
-Required:     false
-MinimumCount: 0
-MaximumCount: 0
-```
-
 ## Output
 
 The `null()` function always returns a JSON null value.
@@ -144,11 +133,11 @@ Type: null
 
 ## Notes
 
-- The `null()` function is particularly useful when working with other functions that handle null values
-  , such as `coalesce()`
-- Unlike undefined or missing values, `null()` explicitly represents the JSON null value
-- When used in object creation with `createObject()`, null properties are included in the resulting object
-- The function takes no arguments and will return an error if any arguments are provided
+- The `null()` function is particularly useful when working with other functions that handle null
+  values, such as `coalesce()`.
+- Unlike undefined or missing values, `null()` explicitly represents the JSON null value.
+- When used in object creation with `createObject()`, null properties are included in the resulting object.
+- The function takes no arguments and will return an error if any arguments are provided.
 
 ## Related functions