update version from 1.0.0-beta.2 to 1.0.0-beta.3 (#190)

* 1.0.0-beta.3 release updates * add collections to overview
radiantearth · Aug 9, 2021 · 68a2cd8 · 68a2cd8
1 parent 55bf82f
commit 68a2cd8
Show file tree

Hide file tree

Showing 30 changed files with 223 additions and 208 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -4,8 +4,21 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+
 ## [Unreleased]
 
+### Added
+
+### Changed
+
+### Deprecated
+
+### Removed
+
+### Fixed
+
+## [v1.0.0-beta.3] - 2020-08-06
+
 ### Added
 - Added STAC API - Collections definition (subset of STAC API - Features)
 

diff --git a/README.md b/README.md
@@ -29,7 +29,7 @@ to search STAC catalogs, where the features returned are STAC [Item](stac-spec/i
 that have common properties, links to their assets and geometries that represent the footprints of the geospatial assets.
 
 The specification for STAC API is provided as files that follow the [OpenAPI](http://openapis.org/) 3.0 specification, 
-rendered online into HTML at <https://api.stacspec.org/v1.0.0-beta.2>, in addition to human-readable documentation.  
+rendered online into HTML at <https://api.stacspec.org/v1.0.0-beta.3>, in addition to human-readable documentation.  
 
 ## Stability Note
 

diff --git a/build/swagger-config.yaml b/build/swagger-config.yaml
@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: STAC API - Complete
-  version: 1.0.0-beta.2
+  version: 1.0.0-beta.3
 apis:
   - url: 'build/core/openapi.yaml'
     paths:

diff --git a/collections/README.md b/collections/README.md
@@ -7,7 +7,7 @@
   - [Conformance](#conformance)
 
 - **OpenAPI specification:** Missing
-- **Conformance URI:** <http://stacspec.org/spec/api/1.0.0-beta.2/extensions/collections>
+- **Conformance URI:** <http://stacspec.org/spec/api/1.0.0-beta.3/extensions/collections>
 - **Extension [Maturity Classification](../extensions.md#extension-maturity):** Pilot
 - **Dependencies**: [STAC API - Core](../core)
 
@@ -25,42 +25,42 @@ aim to align with it. But it still seems to be in flux.*
 
 The following Link relations should exist in the Landing Page (root).
 
-| **rel**        | **href**             | **From**       | **Description** |
-| -------------- | -------------------- | -------------- | ---------------- |
-| `root`         | `/`                  | STAC Core      | The root URI |
-| `self`         | `/`                  | OAFeat         | Self reference, same as root URI |
+| **rel**        | **href**             | **From**       | **Description**                                                                                                                                                         |
+| -------------- | -------------------- | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `root`         | `/`                  | STAC Core      | The root URI                                                                                                                                                            |
+| `self`         | `/`                  | OAFeat         | Self reference, same as root URI                                                                                                                                        |
 | `service-desc` | `/api` (recommended) | OAFeat OpenAPI | The OpenAPI service description. Uses the `application/vnd.oai.openapi+json;version=3.0` media type to refer to the OpenAPI 3.0 document that defines the service's API |
-| `child`        | various              | STAC Core      | The child STAC Catalogs & Collections. Provides curated paths to get to STAC Collection and Item objects |
-| `data` | `/collections` | OAFeat | List of Collections |
+| `child`        | various              | STAC Core      | The child STAC Catalogs & Collections. Provides curated paths to get to STAC Collection and Item objects                                                                |
+| `data`         | `/collections`       | OAFeat         | List of Collections                                                                                                                                                     |
 
 Additionally, a `service-doc` endpoint is recommended.
 
-| **rel**      | **href** | **From**       | **Description** |
-| ------------ | -------- | -------------- |----------------- |
-| `service-doc`  | `/api.html` (recommended) | OAFeat OpenAPI | An HTML service description.  Uses the `text/html` media type to refer to a human-consumable description of the service |
+| **rel**       | **href**                  | **From**       | **Description**                                                                                                         |
+| ------------- | ------------------------- | -------------- | ----------------------------------------------------------------------------------------------------------------------- |
+| `service-doc` | `/api.html` (recommended) | OAFeat OpenAPI | An HTML service description.  Uses the `text/html` media type to refer to a human-consumable description of the service |
 
 The following Link relations should exist in the `/collections` endpoint response.
 
-| **rel**        | **href**             | **From**       | **Description** |
-| -------------- | -------------------- | -------------- | ---------------- |
-| `root`         | `/`                  | STAC Core      | The root URI |
-| `self`         | `/collections`       | OAFeat         | Self reference |
+| **rel** | **href**       | **From**  | **Description** |
+| ------- | -------------- | --------- | --------------- |
+| `root`  | `/`            | STAC Core | The root URI    |
+| `self`  | `/collections` | OAFeat    | Self reference  |
 
 The following Link relations should exist in the `/collections/{collectionId}` endpoint response.
 
-| **rel**        | **href**             | **From**       | **Description** |
-| -------------- | -------------------- | -------------- | ---------------- |
-| `root`         | `/`                  | STAC Core      | The root URI |
-| `parent`       | `/`                  | OAFeat         | Parent reference, usually the root Catalog |
-| `self`         | `/collections/{collectionId}` | OAFeat | Self reference |
-| `items`        | `/collections/{collectionId}/items` | OAFeat | Items within Collection |
+| **rel**  | **href**                            | **From**  | **Description**                            |
+| -------- | ----------------------------------- | --------- | ------------------------------------------ |
+| `root`   | `/`                                 | STAC Core | The root URI                               |
+| `parent` | `/`                                 | OAFeat    | Parent reference, usually the root Catalog |
+| `self`   | `/collections/{collectionId}`       | OAFeat    | Self reference                             |
+| `items`  | `/collections/{collectionId}/items` | OAFeat    | Items within Collection                    |
 
 ## Endpoints
 
-| Endpoint                                        | Returns          | Description |
-| ----------------------------------------------- | ---------------- | ----------- |
-| `/collections`                                  | JSON             | Object with a list of Collections contained in the catalog and links |
-| `/collections/{collectionId}`                   | Collection       | Returns single Collection JSON |
+| Endpoint                      | Returns    | Description                                                          |
+| ----------------------------- | ---------- | -------------------------------------------------------------------- |
+| `/collections`                | JSON       | Object with a list of Collections contained in the catalog and links |
+| `/collections/{collectionId}` | Collection | Returns single Collection JSON                                       |
 
 STAC API's implementing the Collections class must support HTTP GET operation at `/collections`, with the return JSON document consisting
 of an array of all STAC Collections and an array of Links.
@@ -134,7 +134,7 @@ and if the canonical location is elsewhere it is recommended to include a `rel`
 
 ## Conformance
 
-Any implementation that provides the STAC Collection functionality described above must add `http://stacspec.org/spec/api/1.0.0-beta.2/collections`,
+Any implementation that provides the STAC Collection functionality described above must add `http://stacspec.org/spec/api/1.0.0-beta.3/collections`,
 the conformance URI, to the `conformsTo` JSON at the landing page.
 
 The core STAC landing page (`/`) must also include a link with a `rel` of `data` that links to the `/collections` endpoint.

diff --git a/collections/openapi.yaml b/collections/openapi.yaml
@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: STAC API - Collections
-  version: '1.0.0-beta.2'
+  version: '1.0.0-beta.3'
   description: >-
     This is an OpenAPI definition of the SpatioTemporal Asset Catalog API - Core
     specification.  This is a subset of the STAC API - Collections specification.
@@ -38,13 +38,13 @@ paths:
               schema:
                 $ref: '../core/openapi.yaml#/components/schemas/landingPage'
               example:
-                stac_version: 1.0.0-beta.2
+                stac_version: 1.0.0-beta.3
                 type: Catalog
                 id: sentinel
                 title: Copernicus Sentinel Imagery
                 description: Catalog of Copernicus Sentinel 1 and 2 imagery.
                 conformsTo:
-                  - 'https://api.stacspec.org/v1.0.0-beta.2/core'
+                  - 'https://api.stacspec.org/v1.0.0-beta.3/core'
                   - 'http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/core'
                   - 'http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/oas30'
                   - 'http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/geojson'

diff --git a/core/README.md b/core/README.md
@@ -5,9 +5,9 @@
   - [Example Landing Page for STAC API - Core](#example-landing-page-for-stac-api---core)
   - [Extensions](#extensions)
 
-- **OpenAPI specification:** [openapi.yaml](openapi.yaml) describes the core endpoints ([rendered version](https://api.stacspec.org/v1.0.0-beta.2/core)),
+- **OpenAPI specification:** [openapi.yaml](openapi.yaml) describes the core endpoints ([rendered version](https://api.stacspec.org/v1.0.0-beta.3/core)),
   and [commons.yaml](commons.yaml) is the OpenAPI version of the core [STAC spec](../stac-spec) JSON Schemas.
-- **Conformance URI:** <https://api.stacspec.org/v1.0.0-beta.2/core>
+- **Conformance URI:** <https://api.stacspec.org/v1.0.0-beta.3/core>
 - **Extension [Maturity Classification](../extensions.md#extension-maturity):** Pilot
 - **Dependencies**: None
 
@@ -50,18 +50,18 @@ API endpoints from OAFeat or STAC API to be implemented, so the following links
 
 The following Link relations should exist in the Landing Page (root).
 
-| **rel**        | **href**             | **From**       | **Description** |
-| -------------- | -------------------- | -------------- | ---------------- |
-| `root`         | `/`                  | STAC Core      | The root URI |
-| `self`         | `/`                  | OAFeat         | Self reference, same as root URI |
+| **rel**        | **href**             | **From**       | **Description**                                                                                                                                                         |
+| -------------- | -------------------- | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `root`         | `/`                  | STAC Core      | The root URI                                                                                                                                                            |
+| `self`         | `/`                  | OAFeat         | Self reference, same as root URI                                                                                                                                        |
 | `service-desc` | `/api` (recommended) | OAFeat OpenAPI | The OpenAPI service description. Uses the `application/vnd.oai.openapi+json;version=3.0` media type to refer to the OpenAPI 3.0 document that defines the service's API |
-| `child`        | various              | STAC Core      | The child STAC Catalogs & Collections. Provides curated paths to get to STAC Collection and Item objects |
+| `child`        | various              | STAC Core      | The child STAC Catalogs & Collections. Provides curated paths to get to STAC Collection and Item objects                                                                |
 
 Additionally, a `service-doc` endpoint is recommended.
 
-| **rel**      | **href** | **From**       | **Description** |
-| ------------ | -------- | -------------- |----------------- |
-| `service-doc`  | `/api.html` (recommended) | OAFeat OpenAPI | An HTML service description.  Uses the `text/html` media type to refer to a human-consumable description of the service |
+| **rel**       | **href**                  | **From**       | **Description**                                                                                                         |
+| ------------- | ------------------------- | -------------- | ----------------------------------------------------------------------------------------------------------------------- |
+| `service-doc` | `/api.html` (recommended) | OAFeat OpenAPI | An HTML service description.  Uses the `text/html` media type to refer to a human-consumable description of the service |
 
 It is also valid to have `item` links from the landing page, but most STAC API services are used to 
 serve up a large number of features, so they typically
@@ -82,7 +82,7 @@ the [overview](../overview.md#example-landing-page) document.
     "title": "A simple STAC API Example",
     "description": "This Catalog aims to demonstrate the a simple landing page",
     "conformsTo" : [
-        "https://api.stacspec.org/v1.0.0-beta.2/core"
+        "https://api.stacspec.org/v1.0.0-beta.3/core"
     ],
     "links": [
         {

diff --git a/core/commons.yaml b/core/commons.yaml
@@ -2,7 +2,7 @@ openapi: 3.0.3
 info:
   title: The SpatioTemporal Asset Catalog API - Commons
   description: This is the OpenAPI version of the core STAC spec JSON Schemas.
-  version: 1.0.0-beta.2
+  version: 1.0.0-beta.3
 paths: {}
 components:
   responses:

diff --git a/core/openapi.yaml b/core/openapi.yaml
@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: STAC API - Core
-  version: 1.0.0-beta.2
+  version: 1.0.0-beta.3
   description: >-
     This is an OpenAPI definition of the SpatioTemporal Asset Catalog API - Core
     specification. Any service that implements this endpoint to allow discovery of
@@ -63,7 +63,7 @@ components:
             title: Copernicus Sentinel Imagery
             description: Catalog of Copernicus Sentinel 1 and 2 imagery.
             conformsTo:
-              - 'https://api.stacspec.org/v1.0.0-beta.2/core'
+              - 'https://api.stacspec.org/v1.0.0-beta.3/core'
             links:
               - href: 'http://data.example.org/'
                 rel: self