diff --git a/website/cue/reference/remap/functions/object_from_array.cue b/website/cue/reference/remap/functions/object_from_array.cue
index 8831a7c50cd92..803563ea8e95d 100644
--- a/website/cue/reference/remap/functions/object_from_array.cue
+++ b/website/cue/reference/remap/functions/object_from_array.cue
@@ -3,9 +3,9 @@ package metadata
 remap: functions: object_from_array: {
 	category: "Object"
 	description: """
-		Iterate over either one or a pair of arrays and create an object out of all the key, value pairs contained in them.
-		Any entries that are missing the value will use `null` instead.
-		Any keys that are `null` will skip the  corresponding value.
+		Iterate over either one or a pair of arrays and create an object out of all the key-value pairs contained in them.
+		Any entries that are missing the value use `null` instead.
+		Any keys that are `null` skip the  corresponding value.
 
 		If a single parameter is given, it must contain an array of all the input arrays.
 		"""
@@ -19,7 +19,7 @@ remap: functions: object_from_array: {
 		},
 		{
 			name:        "keys"
-			description: "The second array of elements. If not present, the first parameter contains all the arrays."
+			description: "The second array of elements. If not present, the first parameter must contain all the arrays."
 			required:    false
 			type: ["array"]
 		},
@@ -31,7 +31,7 @@ remap: functions: object_from_array: {
 	return: {
 		types: ["object"]
 		rules: [
-			"`object_from_array` is considered fallible if either of the parameters is not an array, or if only the `value` parameter is present and it is not an array of arrays, or if any of the keys are not either a string or `null`.",
+			"`object_from_array` is considered fallible in the following cases: if either of the parameters is not an array; if only the `value` parameter is present and it is not an array of arrays; or if any of the keys are not either a string or `null`.",
 		]
 	}