Add template prefix, make schema more strict (radiantearth/stac-spec#901) and add more comments to schema

Author: m-mohr

README.md

@@ -18,17 +18,17 @@ This is the place to add a short introduction.
 
 ## Item Properties and Collection Fields
 
-| Field Name  | Type                      | Description |
-| ----------- | ------------------------- | ----------- |
-| new_field   | string                    | **REQUIRED**. Describe the required field... |
-| xyz         | [XYZ Object](#xyz-object) | Describe the field... |
-| another_one | \[number]                 | Describe the field... |
+| Field Name           | Type                      | Description |
+| -------------------- | ------------------------- | ----------- |
+| template:new_field   | string                    | **REQUIRED**. Describe the required field... |
+| template:xyz         | [XYZ Object](#xyz-object) | Describe the field... |
+| template:another_one | \[number]                 | Describe the field... |
 
 ### Additional Field Information
 
-#### new_field
+#### template:new_field
 
-This is a much more detailed description of the field `new_field`...
+This is a much more detailed description of the field `template:new_field`...
 
 ### XYZ Object
 

examples/collection.json

@@ -30,26 +30,26 @@
       ]
     }
   },
-  "new_field": "test",
-  "xyz": {
+  "template:new_field": "test",
+  "template:xyz": {
     "x": 1,
     "y": 2,
     "z": 3
   },
-  "another_one": [
+  "template:another_one": [
     1,
     2,
     3
   ],
   "assets": {
     "example": {
       "href": "https://example.com/examples/file.xyz",
-      "new_field": "test"
+      "template:new_field": "test"
     }
   },
   "item_assets": {
     "data": {
-      "new_field": "test"
+      "template:new_field": "test"
     }
   },
   "summaries": {

examples/item.json

@@ -40,13 +40,13 @@
   },
   "properties": {
     "datetime": "2020-12-11T22:38:32Z",
-    "new_field": "test",
-    "xyz": {
+    "template:new_field": "test",
+    "template:xyz": {
       "x": 1,
       "y": 2,
       "z": 3
     },
-    "another_one": [
+    "template:another_one": [
       1,
       2,
       3
@@ -61,7 +61,7 @@
   "assets": {
     "data": {
       "href": "https://example.com/examples/file.xyz",
-      "new_field": "test"
+      "template:new_field": "test"
     }
   }
 }

json-schema/schema.json

@@ -21,8 +21,9 @@
             "properties": {
               "allOf": [
                 {
+                  "$comment": "Require fields here for item properties.",
                   "required": [
-                    "new_field"
+                    "template:new_field"
                   ]
                 },
                 {
@@ -97,10 +98,10 @@
       "$comment": "Add your new fields here. Don't require them here, do that above in the item schema.",
       "type": "object",
       "properties": {
-        "new_field": {
+        "template:new_field": {
           "type": "string"
         },
-        "xyz": {
+        "template:xyz": {
           "type": "object",
           "required": [
             "x",
@@ -119,13 +120,19 @@
             }
           }
         }, 
-        "another_one": {
+        "template:another_one": {
           "type": "array", 
           "items": {
             "type": "number"
           }
         }
-      }
+      },
+      "patternProperties": {
+        "^(?!template:)": {
+          "$comment": "Above, change `template` to the prefix of this extension",
+        }
+      },
+      "additionalProperties": false
     }
   }
 }