Merge pull request #737 from json-schema-org/deprecated

Fix #74: add "deprecated" keyword

Author: Phil Sturgeon

jsonschema-validation.xml

@@ -51,7 +51,7 @@
                 <email>[email protected]</email>
             </address>
         </author>
-        
+
         <author fullname="Ben Hutton" initials="B" surname="Hutton" role="editor">
             <organization>Wellcome Sanger Institute</organization>
             <address>
@@ -956,7 +956,7 @@
                 "const": {
                     "typ": "JWT",
                     "alg": "HS256"
-                }   
+                }
             },
             {
                 "type": "object",
@@ -967,7 +967,7 @@
                 }
             }
         ]
-    }   
+    }
 }]]>
                     </artwork>
                     <postamble>
@@ -1028,6 +1028,27 @@
                 </t>
             </section>
 
+            <section title='"deprecated"'>
+                <t>
+                    The value of this keyword MUST be a boolean.  When multiple occurrences
+                    of this keyword are applicable to a single sub-instance, the resulting
+                    value MUST be true if any occurrence specifies a true value, and MUST
+                    be false otherwise.
+                </t>
+                <t>
+                    If "deprecated" has a value of boolean true, it indicates that applications
+                    SHOULD refrain from usage of the declared property. It MAY mean the property
+                    is going to be removed in the future.
+                </t>
+                <t>
+                    A root schema containing "deprecated" with a value of true indicates the entire
+                    root schema MAY be removed in the future.
+                </t>
+                <t>
+                    Omitting this keyword has the same behavior as a value of false.
+                </t>
+            </section>
+
             <section title='"readOnly" and "writeOnly"'>
                 <t>
                     The value of these keywords MUST be a boolean.  When multiple occurrences

meta/meta-data.json

@@ -17,6 +17,10 @@
             "type": "string"
         },
         "default": true,
+        "deprecated": {
+            "type": "boolean",
+            "default": false
+        },
         "readOnly": {
             "type": "boolean",
             "default": false