Add details on JSON schema processing (#175)

* add details on json schema processing * Update index.html Co-authored-by: Ted Thibodeau Jr <[email protected]> * stronger language/description * Apply suggestions from code review Co-authored-by: Ted Thibodeau Jr <[email protected]> --------- Co-authored-by: Ted Thibodeau Jr <[email protected]>
w3c · Jul 17, 2023 · 5baa14a · 5baa14a
1 parent 51bc8e7
commit 5baa14a
Showing 1 changed file with 15 additions and 1 deletion.
diff --git a/index.html b/index.html
@@ -423,8 +423,22 @@ <h3>Representations of JSON Schema</h3>
       <section class="normative">
         <h2>Processing</h2>
         <p>
-          This section details instructions on how to process Credential Schemas.
+          This section details how to process Credential Schemas, which is commonly referred to
+          as <i>JSON schema validation</i>.
         <p>
+        <p>
+         There are many open source implementations of [[JSON-SCHEMA]] validators across many common programming
+         languages. The <a href="https://openjsf.org/">OpenJS Foundation</a> maintains a list of implementations
+         as a part of the <a href="https://json-schema.org/implementations.html">JSON Schema official documentation</a>.
+        </p>
+        <p>
+         A common feature of a JSON schema validator is the ability to detect the version of a JSON schema document
+         and select the validator for that specific version of [[JSON-SCHEMA]]. This is done by switching on the
+         schema's <code>$schema</code> and picking the corresponding validator. Schemas without a <code>$schema</code>
+         property are not considered valid and MUST not be processed. It is RECOMMENDED that implementers
+         choose validators which possess this capability and are able to limit validation to the 
+         <a href="#json-schema-specifications">JSON schema specifications</a> supported by this document.
+        </p>
         <section>
           <h3>Integrity Validation</h3>
           <p>