Skip to content

Commit

Permalink
prep for 1.0.0-rc.3 release (#410)
Browse files Browse the repository at this point in the history
* prep for 1.0.0-rc.3 release

* update changelog date

* update citation date
  • Loading branch information
philvarner authored Mar 27, 2023
1 parent 13d3dac commit 43078a5
Show file tree
Hide file tree
Showing 15 changed files with 63 additions and 58 deletions.
5 changes: 3 additions & 2 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ 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]
## [v1.0.0-rc.3] - 2023-03-27

## Changed

Expand Down Expand Up @@ -257,7 +257,8 @@ service description must return a 400 Bad Request status code.
See the [stac-spec CHANGELOG](https://github.com/radiantearth/stac-spec/blob/v0.9.0/CHANGELOG.md)
for STAC API releases prior to or equal to version 0.9.0.

[Unreleased]: <https://github.com/radiantearth/stac-api-spec/compare/v1.0.0-rc.2...main>
[Unreleased]: <https://github.com/radiantearth/stac-api-spec/compare/v1.0.0-rc.3...main>
[v1.0.0-rc.3]: <https://github.com/radiantearth/stac-api-spec/tree/v1.0.0-rc.3>
[v1.0.0-rc.2]: <https://github.com/radiantearth/stac-api-spec/tree/v1.0.0-rc.2>
[v1.0.0-rc.1]: <https://github.com/radiantearth/stac-api-spec/tree/v1.0.0-rc.1>
[v1.0.0-beta.5]: <https://github.com/radiantearth/stac-api-spec/tree/v1.0.0-beta.5>
Expand Down
6 changes: 3 additions & 3 deletions CITATION.cff
Original file line number Diff line number Diff line change
Expand Up @@ -8,9 +8,9 @@ preferred-citation:
type: standard
title: "SpatioTemporal Asset Catalog (STAC) API specification"
abstract: "An API to make geospatial assets openly searchable and crawlable."
version: 1.0.0-rc.2
year: 2022
date-released: 2022-10-25
version: 1.0.0-rc.3
year: 2023
date-released: 2023-03-27
license: Apache-2.0
url: https://stacspec.org
repository: https://github.com/radiantearth/stac-api-spec
Expand Down
11 changes: 7 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,8 @@

## Releases (stable)

- [v1.0.0-rc.2](https://github.com/radiantearth/stac-api-spec/tree/v1.0.0-rc.2) (latest)
- [v1.0.0-rc.3](https://github.com/radiantearth/stac-api-spec/tree/v1.0.0-rc.3) (latest)
- [v1.0.0-rc.2](https://github.com/radiantearth/stac-api-spec/tree/v1.0.0-rc.2)
- [v1.0.0-rc.1](https://github.com/radiantearth/stac-api-spec/tree/v1.0.0-rc.1)
- [v1.0.0-beta.5](https://github.com/radiantearth/stac-api-spec/tree/v1.0.0-beta.5)
- [v1.0.0-beta.4](https://github.com/radiantearth/stac-api-spec/tree/v1.0.0-beta.4)
Expand Down Expand Up @@ -57,13 +58,15 @@ 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-rc.2>, in addition to human-readable documentation.
rendered online into HTML at <https://api.stacspec.org/v1.0.0-rc.3>, in addition to human-readable documentation.

## Stability Note

This specification has evolved over the past couple years, and is used in production in a variety of deployments. It is
currently in a 'beta' state, with no major changes anticipated. For v1.0.0-rc.2, we remain fully aligned with [OGC API -
Features](http://docs.opengeospatial.org/is/17-069r3/17-069r3.html) Version 1.0, and we are working to stay aligned
currently in a 'beta' state, with no major changes anticipated.
As of v1.0.0-rc.3, we remain fully aligned with
[OGC API - Features](http://docs.opengeospatial.org/is/17-069r3/17-069r3.html)
Version 1.0, and we are working to stay aligned
as the additional OGC API components mature. This may result in minor changes as things evolve. The STAC API
specification follows [Semantic Versioning](https://semver.org/), so once 1.0.0 is reached any breaking change
will require the spec to go to 2.0.0.
Expand Down
8 changes: 4 additions & 4 deletions core/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,17 +11,17 @@

## Summary

- **OpenAPI specification:** [openapi.yaml](openapi.yaml) ([rendered version](https://api.stacspec.org/v1.0.0-rc.2/core)),
- **OpenAPI specification:** [openapi.yaml](openapi.yaml) ([rendered version](https://api.stacspec.org/v1.0.0-rc.3/core)),
- **Conformance URIs:**
- <https://api.stacspec.org/v1.0.0-rc.2/core>
- <https://api.stacspec.org/v1.0.0-rc.3/core>
- **[Maturity Classification](../README.md#maturity-classification):** Candidate
- **Dependencies**: None
and [commons.yaml](commons.yaml) is the OpenAPI version of the core [STAC spec](../stac-spec) JSON Schemas.

## Overview

All STAC API implementations must implement the *STAC API - Core* conformance class
<https://api.stacspec.org/v1.0.0-rc.2/core>. This requires a server to return from a root endpoint a valid
<https://api.stacspec.org/v1.0.0-rc.3/core>. This requires a server to return from a root endpoint a valid
[STAC Catalog](../stac-spec/catalog-spec/catalog-spec.md) "landing page" that also includes a `conformsTo`
attribute with a string array value. Any API implementing this is considered a minimal, valid STAC API.

Expand Down Expand Up @@ -149,7 +149,7 @@ different conformance classes and a different set of links.
"description": "This Catalog aims to demonstrate a simple landing page",
"type": "Catalog",
"conformsTo" : [
"https://api.stacspec.org/v1.0.0-rc.2/core"
"https://api.stacspec.org/v1.0.0-rc.3/core"
],
"links": [
{
Expand Down
2 changes: 1 addition & 1 deletion core/commons.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -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-rc.2
version: 1.0.0-rc.3
paths: {}
components:
responses:
Expand Down
6 changes: 3 additions & 3 deletions core/openapi.yaml
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
openapi: 3.0.3
info:
title: STAC API - Core
version: 1.0.0-rc.2
version: 1.0.0-rc.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
Expand All @@ -12,7 +12,7 @@ info:
license:
name: Apache License 2.0
url: 'http://www.apache.org/licenses/LICENSE-2.0'
x-conformance-classes: [ "https://api.stacspec.org/v1.0.0-rc.2/core" ]
x-conformance-classes: ['https://api.stacspec.org/v1.0.0-rc.3/core']
tags:
- name: Core
description: essential characteristics of a STAC API
Expand Down Expand Up @@ -64,7 +64,7 @@ components:
title: Copernicus Sentinel Imagery
description: Catalog of Copernicus Sentinel 1 and 2 imagery.
conformsTo:
- 'https://api.stacspec.org/v1.0.0-rc.2/core'
- 'https://api.stacspec.org/v1.0.0-rc.3/core'
links:
- href: 'http://data.example.org/'
rel: self
Expand Down
2 changes: 1 addition & 1 deletion fragments/itemcollection/openapi.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ openapi: 3.0.3
info:
title: The SpatioTemporal Asset Catalog API - Item Collection
description: The specification for a set of items, e.g. returned by a search.
version: 1.0.0-rc.2
version: 1.0.0-rc.3
paths: {}
components:
schemas:
Expand Down
10 changes: 5 additions & 5 deletions item-search/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,17 +19,17 @@

## Summary

- **OpenAPI specification:** [openapi.yaml](openapi.yaml) ([rendered version](https://api.stacspec.org/v1.0.0-rc.2/item-search))
- **OpenAPI specification:** [openapi.yaml](openapi.yaml) ([rendered version](https://api.stacspec.org/v1.0.0-rc.3/item-search))
- **Conformance URIs:**
- <https://api.stacspec.org/v1.0.0-rc.2/item-search>
- <https://api.stacspec.org/v1.0.0-rc.3/item-search>
- **[Maturity Classification](../README.md#maturity-classification):** Candidate
- **Dependencies**: [STAC API - Core](../core)
- **Examples**: [examples.md](examples.md)

## Overview

The *STAC API - Item Search* specification defines the *STAC API - Item Search*
conformance class (<https://api.stacspec.org/v1.0.0-rc.2/item-search>), which
conformance class (<https://api.stacspec.org/v1.0.0-rc.3/item-search>), which
provides the ability to search for STAC [Item](../stac-spec/item-spec/README.md)
objects across collections.
It retrieves a group of Item objects that match the provided parameters, wrapped in an
Expand Down Expand Up @@ -275,8 +275,8 @@ the [overview](../overview.md#example-landing-page) document.
"description": "This Catalog aims to demonstrate the a simple landing page",
"type": "Catalog",
"conformsTo" : [
"https://api.stacspec.org/v1.0.0-rc.2/core",
"https://api.stacspec.org/v1.0.0-rc.2/item-search"
"https://api.stacspec.org/v1.0.0-rc.3/core",
"https://api.stacspec.org/v1.0.0-rc.3/item-search"
],
"links": [
{
Expand Down
4 changes: 2 additions & 2 deletions item-search/openapi.yaml
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
openapi: 3.0.3
info:
title: STAC API - Item Search
version: 1.0.0-rc.2
version: 1.0.0-rc.3
description: >-
This is an OpenAPI definition of the SpatioTemporal Asset Catalog API - Item Search
specification.
Expand All @@ -14,7 +14,7 @@ info:
tags:
- name: Item Search
description: essential characteristics of a STAC API
x-conformance-classes: [ "https://api.stacspec.org/v1.0.0-rc.2/item-search" ]
x-conformance-classes: ['https://api.stacspec.org/v1.0.0-rc.3/item-search']
paths:
/search:
get:
Expand Down
24 changes: 12 additions & 12 deletions ogcapi-features/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,11 +26,11 @@
## Summary

- **OpenAPI specifications:**
- [STAC API - Features](openapi-features.yaml) ([rendered version](https://api.stacspec.org/v1.0.0-rc.2/ogcapi-features))
- [STAC API - Collections](openapi-collections.yaml) ([rendered version](https://api.stacspec.org/v1.0.0-rc.2/collections))
- [STAC API - Features](openapi-features.yaml) ([rendered version](https://api.stacspec.org/v1.0.0-rc.3/ogcapi-features))
- [STAC API - Collections](openapi-collections.yaml) ([rendered version](https://api.stacspec.org/v1.0.0-rc.3/collections))
- **Conformance Class URIs:**
- <https://api.stacspec.org/v1.0.0-rc.2/ogcapi-features> - Features
- <https://api.stacspec.org/v1.0.0-rc.2/collections> - Collections
- <https://api.stacspec.org/v1.0.0-rc.3/ogcapi-features> - Features
- <https://api.stacspec.org/v1.0.0-rc.3/collections> - Collections
- **[Maturity Classification](../README.md#maturity-classification):** Candidate
- **Dependencies**:
- [STAC API - Core](../core)
Expand All @@ -51,19 +51,19 @@ entities. As these entities are also GeoJSON types, the GeoJSON conformance clas

While OAFeat defines a single conformance class for its endpoints, STAC API divides these behaviors into two
conformance classes -- Collections and Features. The STAC API - Features
(<https://api.stacspec.org/v1.0.0-rc.2/ogcapi-features>) conformance class includes and extends the behavior
of OAFeat, while the STAC API - Collections (<https://api.stacspec.org/v1.0.0-rc.2/collections>) conformance
(<https://api.stacspec.org/v1.0.0-rc.3/ogcapi-features>) conformance class includes and extends the behavior
of OAFeat, while the STAC API - Collections (<https://api.stacspec.org/v1.0.0-rc.3/collections>) conformance
class is the subset of Features that pertains only to Collections.

### STAC API - Features

The *STAC API - Features* (<https://api.stacspec.org/v1.0.0-rc.2/ogcapi-features>) conformance class
The *STAC API - Features* (<https://api.stacspec.org/v1.0.0-rc.3/ogcapi-features>) conformance class
encompasses all of the behavior described in this specification, as
derived from OAFeat.

### STAC API - Collections

The *STAC API - Collections* (<https://api.stacspec.org/v1.0.0-rc.2/collections>) conformance class
The *STAC API - Collections* (<https://api.stacspec.org/v1.0.0-rc.3/collections>) conformance class
requires only the subset of the behavior of Features that relates to Collections.

This subset is:
Expand All @@ -77,7 +77,7 @@ without needing to implement the entire *STAC API - Features* conformance class.

### OGC API - Features - Part 1: Core

A STAC API implementation that conforms to *STAC API - Features* (<https://api.stacspec.org/v1.0.0-rc.2/ogcapi-features>)
A STAC API implementation that conforms to *STAC API - Features* (<https://api.stacspec.org/v1.0.0-rc.3/ogcapi-features>)
also conforms to
[OGC API - Features - Part 1 Requirements Class Core](http://docs.opengeospatial.org/is/17-069r3/17-069r3.html#rc_core)
conformance class (<http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/core>).
Expand Down Expand Up @@ -355,9 +355,9 @@ the [overview](../overview.md#example-landing-page) document.
"description": "This Catalog aims to demonstrate the a simple landing page",
"type": "Catalog",
"conformsTo" : [
"https://api.stacspec.org/v1.0.0-rc.2/core",
"https://api.stacspec.org/v1.0.0-rc.2/ogcapi-features",
"https://api.stacspec.org/v1.0.0-rc.2/collections",
"https://api.stacspec.org/v1.0.0-rc.3/core",
"https://api.stacspec.org/v1.0.0-rc.3/ogcapi-features",
"https://api.stacspec.org/v1.0.0-rc.3/collections",
"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"
Expand Down
6 changes: 3 additions & 3 deletions ogcapi-features/openapi-collections.yaml
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
openapi: 3.0.3
info:
title: STAC API - Collections
version: 1.0.0-rc.2
version: 1.0.0-rc.3
description: >-
This is an OpenAPI definition of the SpatioTemporal Asset Catalog API - Collections
specification. This is a subset of the STAC API - Features specification.
Expand All @@ -11,7 +11,7 @@ info:
license:
name: Apache License 2.0
url: 'http://www.apache.org/licenses/LICENSE-2.0'
x-conformance-classes: [ "https://api.stacspec.org/v1.0.0-rc.2/collections" ]
x-conformance-classes: ['https://api.stacspec.org/v1.0.0-rc.3/collections']
tags:
- name: Core
description: essential characteristics of a STAC API
Expand Down Expand Up @@ -46,7 +46,7 @@ paths:
title: Copernicus Sentinel Imagery
description: Catalog of Copernicus Sentinel 1 and 2 imagery.
conformsTo:
- 'https://api.stacspec.org/v1.0.0-rc.2/core'
- 'https://api.stacspec.org/v1.0.0-rc.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'
Expand Down
9 changes: 5 additions & 4 deletions ogcapi-features/openapi-features.yaml
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
openapi: 3.0.3
info:
title: STAC API - Features
version: 1.0.0-rc.2
version: 1.0.0-rc.3
description: >-
This is an OpenAPI definition of the SpatioTemporal Asset Catalog API - Features
specification. This extends OGC API - Features - Part 1: Core.
Expand All @@ -11,7 +11,8 @@ info:
license:
name: Apache License 2.0
url: 'http://www.apache.org/licenses/LICENSE-2.0'
x-conformance-classes: [ "https://api.stacspec.org/v1.0.0-rc.2/ogcapi-features" ]
x-conformance-classes:
['https://api.stacspec.org/v1.0.0-rc.3/ogcapi-features']
tags:
- name: Features
description: |-
Expand Down Expand Up @@ -45,7 +46,7 @@ paths:
title: Copernicus Sentinel Imagery
description: Catalog of Copernicus Sentinel 1 and 2 imagery.
conformsTo:
- 'https://api.stacspec.org/v1.0.0-rc.2/core'
- 'https://api.stacspec.org/v1.0.0-rc.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'
Expand Down Expand Up @@ -99,7 +100,7 @@ paths:
'200':
$ref: '#/components/responses/Collections'
'4XX':
$ref: '../core/commons.yaml#/components/responses/Error'
$ref: '../core/commons.yaml#/components/responses/Error'
'5XX':
$ref: '../core/commons.yaml#/components/responses/Error'
'/collections/{collectionId}':
Expand Down
Loading

0 comments on commit 43078a5

Please sign in to comment.