DOCSP-21988 doc for items value type (#251)

* DOCSP-21988 doc for items value type

* Update source/reference/cli/sql/sqlsetschema.txt

Copy review feedback

Co-authored-by: zach-carr <[email protected]>

* DOCSP-21988 update for review feedback

Co-authored-by: zach-carr <[email protected]>

Author: kanchana-mongodb

source/reference/cli/sql/sqlgenerateschema.txt

@@ -173,13 +173,11 @@ more about the fields in the output, see
 							 "bsonType" : [
 							   "array"
 							 ],
-							 "items" : [
-							   {
-								 "bsonType" : [
-								   "int"
-								 ]
-							   }
-							 ]
+							 "items" : {
+							   "bsonType" : [
+								 "int"
+							   ]
+							 }
 						   }
 						 }
 					   }
@@ -261,22 +259,18 @@ more about the fields in the output, see
 							     ]
 							   }
 						     },
-						     "items" : [
-							   {
-							     "bsonType" : [
-								   "int"
-							     ]
-						       }
-						     ]
+						     "items" : {
+							   "bsonType" : [
+								 "int"
+							   ]
+						     }
 					       }
 					     },
-					     "items" : [
-					       {
-						     "bsonType" : [
-						       "int"
-						     ]
-					       }
-					     ]
+					     "items" : {
+						   "bsonType" : [
+						     "int"
+						   ]
+					     }
 				       }
 				     }
 			       },

source/reference/cli/sql/sqlgetschema.txt

@@ -168,22 +168,18 @@ information on the fields in the output, see
 						   ]
 						 }
 					   },
-					   "items" : [
-						 {
-						   "bsonType" : [
-							 "int"
-						   ]
-						 }
-					   ]
+					   "items" : {
+						 "bsonType" : [
+						   "int"
+						 ]
+					   }
 					 }
 				   },
-				   "items" : [
-					 {
-					   "bsonType" : [
-						 "int"
-					   ]
-					 }
-				   ]
+				   "items" : {
+					 "bsonType" : [
+					   "int"
+					 ]
+				   }
 				 }
 			   }
 			 },

source/reference/cli/sql/sqlsetschema.txt

@@ -70,7 +70,14 @@ Parameters
      - document
      - The format version of the schema and the |json| schema to set 
        the schema for the collection or view or an empty document to 
-       remove the schema for the collection or view.
+       remove the schema for the collection or view. 
+
+       .. note:: 
+
+          You can provide a single document or an array of documents 
+          in the ``items`` field. When you retrieve the schema, 
+          ``items`` shows the form that you used to set the schema.
+
      - Required
 
 .. _sqlsetschema-output:
@@ -112,7 +119,7 @@ the ``egData`` collection.
 
 .. code-block:: sh 
 
-   db.runCommand({sqlSetSchema : "egData", "schema" : { "version" : NumberLong(1), "jsonSchema" : { "bsonType" : [ "object" ], "properties" : { "a" : { "bsonType" : [ "object" ], "properties" : { "b" : { "bsonType" : [ "object", "array" ], "properties" : { "c" : { "bsonType" : [ "array", "string", "object", "null" ], "properties" : { "d" : { "bsonType" : [ "int" ] } }, "items" : [ { "bsonType" : [ "int" ] } ] } }, "items" : [ { "bsonType" : [ "int" ] } ] } } }, "s" : { "bsonType" : [ "int", "object" ], "properties" : { "b" : { "bsonType" : [ "object" ], "properties" : { "c" : { "bsonType" : [ "object" ], "properties" : { "d" : { "bsonType" : [ "array" ], "items" : [ { "bsonType" : [ "string" ] } ] } } } } } } } } } }})
+   db.runCommand({sqlSetSchema : "egData", "schema" : { "version" : NumberLong(1), "jsonSchema" : { "bsonType" : [ "object" ], "properties" : { "a" : { "bsonType" : [ "object" ], "properties" : { "b" : { "bsonType" : [ "object", "array" ], "properties" : { "c" : { "bsonType" : [ "array", "string", "object", "null" ], "properties" : { "d" : { "bsonType" : [ "int" ] } }, "items" : { "bsonType" : [ "int" ] } } }, "items" : { "bsonType" : [ "int" ] } } } }, "s" : { "bsonType" : [ "int", "object" ], "properties" : { "b" : { "bsonType" : [ "object" ], "properties" : { "c" : { "bsonType" : [ "object" ], "properties" : { "d" : { "bsonType" : [ "array" ], "items" : { "bsonType" : [ "string" ] } } } } } } } } } } }})
 
 The previous command returns the following output.
 

source/reference/format/sql-schema-format.txt

@@ -68,6 +68,12 @@ Supported JSON Schema Fields
 - ``items`` 
 - ``properties``
 
+.. note:: 
+
+   You can provide a single document or an array of documents for the 
+   ``items`` field. When you retrieve the schema, the ``items`` field 
+   shows the form that you used for setting the schema.
+
 To learn more about these fields, see :manual:`JSON Schema Keywords 
 </reference/operator/query/jsonSchema/#jsonschema-keywords>`.