Skip to content

Commit a779348

Browse files
Merge pull request #857 from radiantearth/typos-and-api
Minor fixes
2 parents ee6f642 + a2a3f5c commit a779348

File tree

5 files changed

+7
-8
lines changed

5 files changed

+7
-8
lines changed

catalog-spec/catalog-spec.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ also a valid STAC Catalog.
3636
| description | string | **REQUIRED.** Detailed multi-line description to fully explain the catalog. [CommonMark 0.29](http://commonmark.org/) syntax MAY be used for rich text representation. |
3737
| links | [[Link Object](#link-object)] | **REQUIRED.** A list of references to other documents. |
3838

39-
**stac_extensions**: A list of extensions the Catalog implements. This does NOT declare the extensions of children or Items. The list contains URLs to the JSON Schema files it can be validated against. For official [content extensions](../extensions/README.md#list-of-content-extensions), a "shortcut" can be used. This means you can specify the folder name of the extension, for example `pointcloud` for the Point Cloud extension. This does *not* apply for API extensions. If the versions of the extension and the catalog diverge, you can specify the URL of the JSON schema file.
39+
**stac_extensions**: A list of extensions the Catalog implements. This does NOT declare the extensions of children or Items. The list contains URLs to the JSON Schema files it can be validated against. For official [content extensions](../extensions/README.md#list-of-content-extensions), a "shortcut" can be used. This means you can specify the folder name of the extension, for example `single-file-stac` for the Point Cloud extension. If the versions of the extension and the catalog diverge, you can specify the URL of the JSON schema file.
4040
This list must only contain extensions that extend the Catalog itself, see the the 'Scope' column in the list of extensions.
4141

4242
### Link Object

collection-spec/collection-spec.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ STAC Collections are meant to be compatible with *OGC API - Features* Collection
2929
| summaries | Map<string, \[*]\|[Stats Object](#stats-object)> | A map of property summaries, either a set of values or statistics such as a range. |
3030
| links | \[[Link Object](#link-object)] | **REQUIRED.** A list of references to other documents. |
3131

32-
**stac_extensions**: A list of extensions the Collection implements. This does NOT declare the extensions of child Catalogs or Items. The list contains URLs to the JSON Schema files it can be validated against. For official [content extensions](../extensions/README.md#list-of-content-extensions), a "shortcut" can be used. This means you can specify the folder name of the extension, for example `version` for the Versioning Indicators extension. This does *not* apply for API extensions. If the versions of the extension and the collection diverge, you can specify the URL of the JSON schema file.
32+
**stac_extensions**: A list of extensions the Collection implements. This does NOT declare the extensions of child Catalogs or Items. The list contains URLs to the JSON Schema files it can be validated against. For official [content extensions](../extensions/README.md#list-of-content-extensions), a "shortcut" can be used. This means you can specify the folder name of the extension, for example `version` for the Versioning Indicators extension. If the versions of the extension and the collection diverge, you can specify the URL of the JSON schema file.
3333
This list must only contain extensions that extend the Collection itself, see the the 'Scope' column in the list of extensions. If an extension as the extension has influence on multiple parts of the whole catalog 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 provide 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 still does not list the `sat` extension in the `stac_extensions` field.
3434

3535
**license**: Collection's license(s) as a SPDX [License identifier](https://spdx.org/licenses/). Alternatively, use `proprietary` (see below) if the license is not on the SPDX license list or `various` if multiple licenses apply. In all cases links to the license texts SHOULD be added, see the `license` link relation type. If no link to a license is included and the `license` field is set to `proprietary`, the collection is private, and consumers have not been granted any explicit right to use the data.
@@ -144,7 +144,7 @@ Implementors are free to add other derived statistical values to the object, for
144144
STAC Collections which don't link to any Item are called **standalone Collections**.
145145
To describe them with more fields than the Collection fields has to offer, it is allowed to re-use the metadata fields defined by content extensions for Items in the `summaries` field.
146146
This makes much sense for fields such as `platform` or `proj:epsg`, which are often the same for a whole collection, but doesn't make much sense for `eo:cloud_cover`, which usually varies heavily across a Collection.
147-
The data provider is free to decide, which fields are reasoable to be used.
147+
The data provider is free to decide, which fields are reasonable to be used.
148148

149149
## Extensions
150150

item-spec/README.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,8 @@
33
The core of a SpatioTemporal Asset Catalog (STAC) is a set of JSON fields defined by the
44
[STAC Item spec](item-spec.md). These fields define an Item - the atomic units that contain
55
metadata for search as plus links to the actual assets that they represent. Their main function
6-
is as the leaf nodes of a [Catalog](../catalog-spec/README.md), and are also returned from the search
7-
endpoints of a `/search` endpoint. See the [overview](../overview.md) document for more information on how all the
8-
pieces fit together.
6+
is as the leaf nodes of a [Catalog](../catalog-spec/README.md).
7+
See the [overview](../overview.md) document for more information on how all the pieces fit together.
98

109
## In this directory
1110

item-spec/common-metadata.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -57,7 +57,7 @@ There are more date and time related fields available in the [Timestamps extensi
5757
### Date and Time Range
5858

5959
While a STAC item can have a nominal datetime describing the capture, these properties allow an item to have a range
60-
of capture datetimes. An example of this is the [MODIS 16 day vegetation index product.](https://lpdaac.usgs.gov/products/mod13q1v006/).
60+
of capture dates and times. An example of this is the [MODIS 16 day vegetation index product.](https://lpdaac.usgs.gov/products/mod13q1v006/).
6161
The datetime property in a STAC item and these fields are not mutually exclusive.
6262

6363
**Important:** Using one of the fields REQUIRES to include the other field as well to enable a user to search STAC records by the provided times. So if you use `start_datetime` you need to add `end_datetime` and vice-versa. Both fields are also REQUIRED if the `datetime` field is set to `null`.

item-spec/item-spec.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -229,7 +229,7 @@ extensions can add further property fields as well. Any property that can be spe
229229
a specific asset. This can be used to override a property defined in the Item, or to specify fields for which there is no
230230
single value for all assets.
231231

232-
**It is important to note that the STAC API does not faciliate searching across Asset properties in this way, and this
232+
**It is important to note that the STAC API does not facilitate searching across Asset properties in this way, and this
233233
should be used sparingly.** It is primarily used to define properties at the Asset level that may be used during use of
234234
the data instead of for searching.
235235

0 commit comments

Comments
 (0)