add description and examples for maximum keyword

content/2020-12/validation/maximum.markdown

@@ -18,3 +18,50 @@ related:
   - vocabulary: validation
     keyword: multipleOf
 ---
+
+The `maximum` keyword is used to set the upper limit on numeric instances. It specifies that the numeric value being validated must be less than or equal to the provided maximum value.
+
+* Applies only to number data types (integers and floats).
+* Validation succeeds if the number is less than or equal to the specified `maximum`.
+
+## Examples
+
+{{<schema `Schema defining the upper limit of 10 on numeric values`>}}
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "number",
+  "maximum": 10
+}
+{{</schema>}}
+
+{{<instance-pass `An instance with a numeric value less than 10 is valid`>}}
+9.5
+{{</instance-pass>}}
+
+{{<instance-fail `An instance with a numeric value greater than 10 is invalid`>}}
+15
+{{</instance-fail>}}
+
+{{<instance-pass `An instance with a numeric value equal to 10 is valid`>}}
+10
+{{</instance-pass>}}
+
+{{<schema ` Schema allowing either a boolean value or a numeric value with an upper limit of 20`>}}
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": [ "boolean", "number" ],
+  "maximum": 20
+}
+{{</schema>}}
+
+{{<instance-pass `An instance with a numeric value less than 20 is valid`>}}
+15
+{{</instance-pass>}}
+
+{{<instance-fail `An instance with a string datatype is invalid`>}}
+"Hello World!"
+{{</instance-fail>}}
+
+{{<instance-pass `An instance with a boolean value is valid`>}}
+true
+{{</instance-pass>}}