From e104106b0ad24b2d2498258928e1fd249d048e9f Mon Sep 17 00:00:00 2001
From: Agnivesh Chaubey <agniveshvapi@gmail.com>
Date: Wed, 21 Feb 2024 23:14:48 +0530
Subject: [PATCH] add description and examples for maximum keyword

---
 content/2020-12/validation/maximum.markdown | 47 +++++++++++++++++++++
 1 file changed, 47 insertions(+)

diff --git a/content/2020-12/validation/maximum.markdown b/content/2020-12/validation/maximum.markdown
index 619235c0..fe25519e 100644
--- a/content/2020-12/validation/maximum.markdown
+++ b/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>}}