chore(repo): update documentation

stoplightio · Jun 7, 2024 · 5bee343 · 5bee343
1 parent 271d950
commit 5bee343
Showing 1 changed file with 31 additions and 0 deletions.
diff --git a/docs/reference/openapi-rules.md b/docs/reference/openapi-rules.md
@@ -448,6 +448,37 @@ TheBadModel:
         - 8
 ```
 
+### array-items
+
+Schemas with `type: array`, require a sibling `items` field.
+
+**Recommended:** Yes
+
+**Good Example**
+
+```yaml
+TheGoodModel:
+  type: object
+  properties:
+    favoriteColorSets:
+      type: array
+      items:
+        type: array
+        items: {}
+```
+
+**Bad Example**
+
+```yaml
+TheBadModel:
+  type: object
+  properties:
+    favoriteColorSets:
+      type: array
+      items:
+        type: array
+```
+
 ## OpenAPI v2.0-only
 
 These rules will only apply to OpenAPI v2.0 documents.