From 0ba3ce7970a87f2023a303596950da49f3c895f4 Mon Sep 17 00:00:00 2001
From: Julian Berman <Julian@GrayVines.com>
Date: Wed, 8 Nov 2023 11:03:59 -0500
Subject: [PATCH] Support including some information about where a test
 behavior is specified.

Refs: json-schema-org/JSON-Schema-Test-Suite#699
---
 test-schema.json | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/test-schema.json b/test-schema.json
index d885a57..e884d84 100644
--- a/test-schema.json
+++ b/test-schema.json
@@ -30,6 +30,38 @@
       "type": "object",
       "properties": {
         "base_uri": { "type": "string", "format": "uri" },
+        "why": {
+          "description": "A human-readable explanation of the results of this test.",
+          "type": "object",
+          "unevaluatedProperties": false,
+          "properties": {
+            "summary": {
+              "description": "A summary of the behavior specified in the linked specifications",
+              "type": "string"
+            },
+            "specifications": {
+              "description": "One or more releavnt specifications for this test.",
+              "type": "array",
+              "minItems": 1,
+              "items": {
+                "type": "object",
+                "oneOf": [{ "required": ["rfc"] }, { "required": ["name"] }],
+                "properties": {
+                  "rfc": {
+                    "description": "An IETF RFC",
+                    "type": "number"
+                  },
+                  "name": {
+                    "description": "Any other specification",
+                    "type": "string"
+                  },
+                  "section": { "type": "string" },
+                  "link": { "type": "string", "format": "uri" }
+                }
+              }
+            }
+          }
+        },
         "ref": { "type": "string" },
         "target": {},
         "then": {