Merge pull request #1025 from json-schema-org/rq/evaluation

Attempt to justify and explain unevaluated keyword phrasing

Author: Relequestual

jsonschema-core.xml

@@ -2576,6 +2576,14 @@
                 to contribute to whether or not the item or property has been evaluated.
                 Only successful evaluations are considered.
             </t>
+            <t>
+                If an item in an array or an object property is "successfully evaluated", it
+                is logically considered to be valid in terms of the representation of the
+                object or array that's expected. For example if a subschema represents a car,
+                which requires between 2-4 wheels, and the value of "wheels" is 6, the instance
+                object is not "evaluated" to be a car, and the "wheels" property is considered
+                "unevaluated (successfully as a known thing)", and does not retain any annotations.
+            </t>
             <t>
                 Recall that adjacent keywords are keywords within the same schema object,
                 and that the dynamic-scope subschemas include reference targets as well as