From 5e37a0edc470ddbb47a12fa4102747f09590d2c7 Mon Sep 17 00:00:00 2001 From: Joris C <3611895+JorisCod@users.noreply.github.com> Date: Wed, 17 Dec 2025 09:48:08 +0100 Subject: [PATCH 1/3] Clarify linking items --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index b5ee35c..62cdc62 100644 --- a/README.md +++ b/README.md @@ -90,7 +90,7 @@ In Item Properties: ### Linking the Items -In Items that declare this `processing` extension, it is recommended to add one or more [Links](https://github.com/radiantearth/stac-spec/blob/master/item-spec/item-spec.md#relation-types) with `derived_from` or `via` relationships to the eventual source metadata & data used in the processing. +In Items that declare this `processing` extension, it is recommended to add one or more [Links](https://github.com/radiantearth/stac-spec/blob/master/item-spec/item-spec.md#relation-types) with `derived_from` or `via` relationships to the eventual source data and metadata used in the processing, respectively. They could be used to trace back the processing history of the dataset. ### Suggested Processing Levels From b7dfc4c09563bc868e90ee0de7a933c62b1c9489 Mon Sep 17 00:00:00 2001 From: Joris C <3611895+JorisCod@users.noreply.github.com> Date: Wed, 7 Jan 2026 10:49:12 +0100 Subject: [PATCH 2/3] Derived_from and via + media type --- README.md | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 62cdc62..ff61de6 100644 --- a/README.md +++ b/README.md @@ -90,8 +90,13 @@ In Item Properties: ### Linking the Items -In Items that declare this `processing` extension, it is recommended to add one or more [Links](https://github.com/radiantearth/stac-spec/blob/master/item-spec/item-spec.md#relation-types) with `derived_from` or `via` relationships to the eventual source data and metadata used in the processing, respectively. -They could be used to trace back the processing history of the dataset. +In Items that declare this processing extension, it is recommended to add one or more [Links](https://github.com/radiantearth/stac-spec/blob/master/item-spec/item-spec.md#relation-types) that document lineage, using `derived_from` to point to upstream inputs the data product was derived from, and `via` to point to alternative representations used in the creation of the Item (e.g., an authoritative metadata record used for conversion). +They could be used to trace back the processing history of the dataset. Note that `derived_from` can point back to different types of metadata, which are distinguished through the media type (`type`): +- `application/geo+json` → STAC Item +- `application/json` → STAC Catalog/Collection; for other JSON metadata, use `application/json; profile=my-other-metadata-standard`. +- `text/html` → website +- Any other media type (e.g. `application/xml`) → other metadata (e.g. XML) + ### Suggested Processing Levels From c30e17f45d1e48fb03095527b6c434040d57327f Mon Sep 17 00:00:00 2001 From: Joris C <3611895+JorisCod@users.noreply.github.com> Date: Thu, 8 Jan 2026 12:53:02 +0100 Subject: [PATCH 3/3] Fix MD --- README.md | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index ff61de6..9511f6c 100644 --- a/README.md +++ b/README.md @@ -90,14 +90,17 @@ In Item Properties: ### Linking the Items -In Items that declare this processing extension, it is recommended to add one or more [Links](https://github.com/radiantearth/stac-spec/blob/master/item-spec/item-spec.md#relation-types) that document lineage, using `derived_from` to point to upstream inputs the data product was derived from, and `via` to point to alternative representations used in the creation of the Item (e.g., an authoritative metadata record used for conversion). -They could be used to trace back the processing history of the dataset. Note that `derived_from` can point back to different types of metadata, which are distinguished through the media type (`type`): +In Items that declare this processing extension, it is recommended to add one or more +[Links](https://github.com/radiantearth/stac-spec/blob/master/item-spec/item-spec.md#relation-types) that document lineage, +using `derived_from` to point to upstream inputs the data product was derived from, +and `via` to point to alternative representations used in the creation of the Item (e.g., an authoritative metadata record used for conversion). +They could be used to trace back the processing history of the dataset. +Note that `derived_from` can point back to different types of metadata, which are distinguished through the media type (`type`): - `application/geo+json` → STAC Item - `application/json` → STAC Catalog/Collection; for other JSON metadata, use `application/json; profile=my-other-metadata-standard`. - `text/html` → website - Any other media type (e.g. `application/xml`) → other metadata (e.g. XML) - ### Suggested Processing Levels The `processing:level` is the name that is commonly used to refer to that processing level properties.