Clarified that stac_extensions should also list extensions that are u…

…sed in Collection summaries
philvarner · Mar 31, 2021 · d73b43f · d73b43f
1 parent 571c3bc
commit d73b43f
Show file tree

Hide file tree

Showing 4 changed files with 17 additions and 18 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -6,6 +6,10 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 ## [Unreleased]
 
+### Changed
+
+- Clarified that stac_extensions should also list extensions that are used in Collection summaries. ([#1077](https://github.com/radiantearth/stac-spec/issues/1077))
+
 ## [v1.0.0-rc.2] - 2021-03-30
 
 ### Changed

diff --git a/catalog-spec/catalog-spec.md b/catalog-spec/catalog-spec.md
@@ -61,9 +61,10 @@ In general, STAC versions can be mixed, but please keep the [recommended best pr
 #### stac_extensions
 
 A list of extensions the Catalog implements.
-This list must only contain extensions that extend the Catalog itself, see the the 'Scope' column in the list of
-extensions. This does NOT declare the extensions of child Catalog, Collection, or Item
-objects. The list contains URLs to the JSON Schema files it can be validated against.
+The list consists of URLs to JSON Schema files that can be used for validation.
+This list must only contain extensions that extend the Catalog specification itself,
+see the the 'Scope' for each of the extensions.
+This must **not** declare the extensions that are only implemented in child Collection or Items.
 
 ### Link Object
 

diff --git a/collection-spec/collection-spec.md b/collection-spec/collection-spec.md
@@ -65,16 +65,11 @@ In general, STAC versions can be mixed, but please keep the [recommended best pr
 
 #### stac_extensions
 
-A list of extensions the Collection implements.  
-This list must only contain extensions that extend the Collection itself, see the the 'Scope' column in the list of 
-extensions. This does NOT declare the extensions of child Collection or Item 
-objects. The list contains URLs to the JSON Schema files it can be validated against.
-
-If an extension has influence on multiple parts 
-of the whole STAC structure, it must be listed in all affected parts (e.g. Collection and Item for the `datacube` extension). 
-If a structure, such as the summaries extension, provides fields in their JSON structure, these extensions must not be listed 
-here as they don't extend the Collection itself. For example, if a Collection includes the field `sat:platform` in the 
-summaries, the Collection should not list the `sat` extension in the `stac_extensions` field.
+A list of extensions the Collection implements.
+The list consists of URLs to JSON Schema files that can be used for validation.
+This list must only contain extensions that extend the Collection specification itself,
+see the the 'Scope' for each of the extensions.
+This must **not** declare the extensions that are only implemented in child Collection or Items.
 
 #### id
 

diff --git a/item-spec/item-spec.md b/item-spec/item-spec.md
@@ -73,11 +73,10 @@ In general, STAC versions can be mixed, but please keep the [recommended best pr
 
 #### stac_extensions
 
-A list of extensions the Item implements.  
-This list must only contain extensions that extend the Item itself, see the the 'Scope' column in the list of 
-extensions. The list contains URLs to the JSON Schema files it can be validated against.
-If an extension such as the `tiled-assets` extension has influence on multiple parts of the whole catalog 
-structure, it must be listed in all affected parts (e.g. Catalog, Collection and Item for the `tiled-assets` extension).
+A list of extensions the Item implements.
+The list consists of URLs to JSON Schema files that can be used for validation.
+This list must only contain extensions that extend the Item specification itself,
+see the the 'Scope' for each of the extensions.
 
 #### id