Merge pull request #13 from SmartBear-DevRel/feat/validation-error

Add validation-error type

src/pages/index.astro

@@ -58,7 +58,12 @@ import Card from '../components/Card.astro';
 				href="./invalid-request-parameter-value"
 				title="Invalid Request Parameter Value"
 				body="One or more of the query or path parameter values are invalid ⚠️"
-			/>																	
+			/>
+            <Card
+                href="./validation-error"
+                title="Validation Error"
+                body="The request is invalid and deemed unprocessable ⚠️"
+            />
 			<Card
 				href="./business-rule-violation"
 				title="Business Rule Violation"

src/pages/validation-error.md

@@ -0,0 +1,37 @@
+---
+layout: ../layouts/Problem.astro
+title: Validation Error
+description: This problem occurs when the request is deemed unprocessable. 
+---
+
+Your client issued a request that failed validation. Certain validation libraries return multi-errors and cannot be easily parsed into discreet types. This problem type, afforded the provider with the ability to surface all validation errors and negate the need for a trial and error workflow on your side. 
+
+Please review your request to determine if you can remain within appropriate business rules. Consider validating your request against available metadata (e.g. schemas) prior to sending to the server.
+
+| Type URI | Title | Recommended HTTP Status Code | Reference |
+|----------|-------|------------------------------|-----------|
+|https://problems-registry.smartbear.com/validation-error|Validation Error|422||
+
+> **Note** A problem is generally **not** meant to be used for end-user input validation, but for client developer convenience. 
+
+**Example of a `validation-error` problem details:**
+
+```json
+{
+    "type": "https://problems-registry.smartbear.com/validation-error",
+    "title": "Validation Error",
+    "detail": "The request is not valid.",
+    "status": 422,
+    "code": "422-02",
+    "errors": [
+        {
+            "detail": "Your request does not contain the required property {name}",
+            "pointer": "#/name"
+        },
+        {
+            "detail": "the path parameter does not conform to the expect format",
+            "parameter": "petId"
+        }       
+     ]
+}
+```