Skip to content

Commit 43078a5

Browse files
authored
prep for 1.0.0-rc.3 release (#410)
* prep for 1.0.0-rc.3 release * update changelog date * update citation date
1 parent 13d3dac commit 43078a5

15 files changed

+63
-58
lines changed

CHANGELOG.md

+3-2
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ All notable changes to this project will be documented in this file.
55
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
66
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
77

8-
## [Unreleased]
8+
## [v1.0.0-rc.3] - 2023-03-27
99

1010
## Changed
1111

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

260-
[Unreleased]: <https://github.com/radiantearth/stac-api-spec/compare/v1.0.0-rc.2...main>
260+
[Unreleased]: <https://github.com/radiantearth/stac-api-spec/compare/v1.0.0-rc.3...main>
261+
[v1.0.0-rc.3]: <https://github.com/radiantearth/stac-api-spec/tree/v1.0.0-rc.3>
261262
[v1.0.0-rc.2]: <https://github.com/radiantearth/stac-api-spec/tree/v1.0.0-rc.2>
262263
[v1.0.0-rc.1]: <https://github.com/radiantearth/stac-api-spec/tree/v1.0.0-rc.1>
263264
[v1.0.0-beta.5]: <https://github.com/radiantearth/stac-api-spec/tree/v1.0.0-beta.5>

CITATION.cff

+3-3
Original file line numberDiff line numberDiff line change
@@ -8,9 +8,9 @@ preferred-citation:
88
type: standard
99
title: "SpatioTemporal Asset Catalog (STAC) API specification"
1010
abstract: "An API to make geospatial assets openly searchable and crawlable."
11-
version: 1.0.0-rc.2
12-
year: 2022
13-
date-released: 2022-10-25
11+
version: 1.0.0-rc.3
12+
year: 2023
13+
date-released: 2023-03-27
1414
license: Apache-2.0
1515
url: https://stacspec.org
1616
repository: https://github.com/radiantearth/stac-api-spec

README.md

+7-4
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,8 @@
1515

1616
## Releases (stable)
1717

18-
- [v1.0.0-rc.2](https://github.com/radiantearth/stac-api-spec/tree/v1.0.0-rc.2) (latest)
18+
- [v1.0.0-rc.3](https://github.com/radiantearth/stac-api-spec/tree/v1.0.0-rc.3) (latest)
19+
- [v1.0.0-rc.2](https://github.com/radiantearth/stac-api-spec/tree/v1.0.0-rc.2)
1920
- [v1.0.0-rc.1](https://github.com/radiantearth/stac-api-spec/tree/v1.0.0-rc.1)
2021
- [v1.0.0-beta.5](https://github.com/radiantearth/stac-api-spec/tree/v1.0.0-beta.5)
2122
- [v1.0.0-beta.4](https://github.com/radiantearth/stac-api-spec/tree/v1.0.0-beta.4)
@@ -57,13 +58,15 @@ to search STAC catalogs, where the features returned are STAC [Item](stac-spec/i
5758
that have common properties, links to their assets and geometries that represent the footprints of the geospatial assets.
5859

5960
The specification for STAC API is provided as files that follow the [OpenAPI](http://openapis.org/) 3.0 specification,
60-
rendered online into HTML at <https://api.stacspec.org/v1.0.0-rc.2>, in addition to human-readable documentation.
61+
rendered online into HTML at <https://api.stacspec.org/v1.0.0-rc.3>, in addition to human-readable documentation.
6162

6263
## Stability Note
6364

6465
This specification has evolved over the past couple years, and is used in production in a variety of deployments. It is
65-
currently in a 'beta' state, with no major changes anticipated. For v1.0.0-rc.2, we remain fully aligned with [OGC API -
66-
Features](http://docs.opengeospatial.org/is/17-069r3/17-069r3.html) Version 1.0, and we are working to stay aligned
66+
currently in a 'beta' state, with no major changes anticipated.
67+
As of v1.0.0-rc.3, we remain fully aligned with
68+
[OGC API - Features](http://docs.opengeospatial.org/is/17-069r3/17-069r3.html)
69+
Version 1.0, and we are working to stay aligned
6770
as the additional OGC API components mature. This may result in minor changes as things evolve. The STAC API
6871
specification follows [Semantic Versioning](https://semver.org/), so once 1.0.0 is reached any breaking change
6972
will require the spec to go to 2.0.0.

core/README.md

+4-4
Original file line numberDiff line numberDiff line change
@@ -11,17 +11,17 @@
1111

1212
## Summary
1313

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

2121
## Overview
2222

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

@@ -149,7 +149,7 @@ different conformance classes and a different set of links.
149149
"description": "This Catalog aims to demonstrate a simple landing page",
150150
"type": "Catalog",
151151
"conformsTo" : [
152-
"https://api.stacspec.org/v1.0.0-rc.2/core"
152+
"https://api.stacspec.org/v1.0.0-rc.3/core"
153153
],
154154
"links": [
155155
{

core/commons.yaml

+1-1
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@ openapi: 3.0.3
22
info:
33
title: The SpatioTemporal Asset Catalog API - Commons
44
description: This is the OpenAPI version of the core STAC spec JSON Schemas.
5-
version: 1.0.0-rc.2
5+
version: 1.0.0-rc.3
66
paths: {}
77
components:
88
responses:

core/openapi.yaml

+3-3
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
openapi: 3.0.3
22
info:
33
title: STAC API - Core
4-
version: 1.0.0-rc.2
4+
version: 1.0.0-rc.3
55
description: >-
66
This is an OpenAPI definition of the SpatioTemporal Asset Catalog API - Core
77
specification. Any service that implements this endpoint to allow discovery of
@@ -12,7 +12,7 @@ info:
1212
license:
1313
name: Apache License 2.0
1414
url: 'http://www.apache.org/licenses/LICENSE-2.0'
15-
x-conformance-classes: [ "https://api.stacspec.org/v1.0.0-rc.2/core" ]
15+
x-conformance-classes: ['https://api.stacspec.org/v1.0.0-rc.3/core']
1616
tags:
1717
- name: Core
1818
description: essential characteristics of a STAC API
@@ -64,7 +64,7 @@ components:
6464
title: Copernicus Sentinel Imagery
6565
description: Catalog of Copernicus Sentinel 1 and 2 imagery.
6666
conformsTo:
67-
- 'https://api.stacspec.org/v1.0.0-rc.2/core'
67+
- 'https://api.stacspec.org/v1.0.0-rc.3/core'
6868
links:
6969
- href: 'http://data.example.org/'
7070
rel: self

fragments/itemcollection/openapi.yaml

+1-1
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@ openapi: 3.0.3
22
info:
33
title: The SpatioTemporal Asset Catalog API - Item Collection
44
description: The specification for a set of items, e.g. returned by a search.
5-
version: 1.0.0-rc.2
5+
version: 1.0.0-rc.3
66
paths: {}
77
components:
88
schemas:

item-search/README.md

+5-5
Original file line numberDiff line numberDiff line change
@@ -19,17 +19,17 @@
1919

2020
## Summary
2121

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

2929
## Overview
3030

3131
The *STAC API - Item Search* specification defines the *STAC API - Item Search*
32-
conformance class (<https://api.stacspec.org/v1.0.0-rc.2/item-search>), which
32+
conformance class (<https://api.stacspec.org/v1.0.0-rc.3/item-search>), which
3333
provides the ability to search for STAC [Item](../stac-spec/item-spec/README.md)
3434
objects across collections.
3535
It retrieves a group of Item objects that match the provided parameters, wrapped in an
@@ -275,8 +275,8 @@ the [overview](../overview.md#example-landing-page) document.
275275
"description": "This Catalog aims to demonstrate the a simple landing page",
276276
"type": "Catalog",
277277
"conformsTo" : [
278-
"https://api.stacspec.org/v1.0.0-rc.2/core",
279-
"https://api.stacspec.org/v1.0.0-rc.2/item-search"
278+
"https://api.stacspec.org/v1.0.0-rc.3/core",
279+
"https://api.stacspec.org/v1.0.0-rc.3/item-search"
280280
],
281281
"links": [
282282
{

item-search/openapi.yaml

+2-2
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
openapi: 3.0.3
22
info:
33
title: STAC API - Item Search
4-
version: 1.0.0-rc.2
4+
version: 1.0.0-rc.3
55
description: >-
66
This is an OpenAPI definition of the SpatioTemporal Asset Catalog API - Item Search
77
specification.
@@ -14,7 +14,7 @@ info:
1414
tags:
1515
- name: Item Search
1616
description: essential characteristics of a STAC API
17-
x-conformance-classes: [ "https://api.stacspec.org/v1.0.0-rc.2/item-search" ]
17+
x-conformance-classes: ['https://api.stacspec.org/v1.0.0-rc.3/item-search']
1818
paths:
1919
/search:
2020
get:

ogcapi-features/README.md

+12-12
Original file line numberDiff line numberDiff line change
@@ -26,11 +26,11 @@
2626
## Summary
2727

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

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

5858
### STAC API - Features
5959

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

6464
### STAC API - Collections
6565

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

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

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

80-
A STAC API implementation that conforms to *STAC API - Features* (<https://api.stacspec.org/v1.0.0-rc.2/ogcapi-features>)
80+
A STAC API implementation that conforms to *STAC API - Features* (<https://api.stacspec.org/v1.0.0-rc.3/ogcapi-features>)
8181
also conforms to
8282
[OGC API - Features - Part 1 Requirements Class Core](http://docs.opengeospatial.org/is/17-069r3/17-069r3.html#rc_core)
8383
conformance class (<http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/core>).
@@ -355,9 +355,9 @@ the [overview](../overview.md#example-landing-page) document.
355355
"description": "This Catalog aims to demonstrate the a simple landing page",
356356
"type": "Catalog",
357357
"conformsTo" : [
358-
"https://api.stacspec.org/v1.0.0-rc.2/core",
359-
"https://api.stacspec.org/v1.0.0-rc.2/ogcapi-features",
360-
"https://api.stacspec.org/v1.0.0-rc.2/collections",
358+
"https://api.stacspec.org/v1.0.0-rc.3/core",
359+
"https://api.stacspec.org/v1.0.0-rc.3/ogcapi-features",
360+
"https://api.stacspec.org/v1.0.0-rc.3/collections",
361361
"http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/core",
362362
"http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/oas30",
363363
"http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/geojson"

ogcapi-features/openapi-collections.yaml

+3-3
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
openapi: 3.0.3
22
info:
33
title: STAC API - Collections
4-
version: 1.0.0-rc.2
4+
version: 1.0.0-rc.3
55
description: >-
66
This is an OpenAPI definition of the SpatioTemporal Asset Catalog API - Collections
77
specification. This is a subset of the STAC API - Features specification.
@@ -11,7 +11,7 @@ info:
1111
license:
1212
name: Apache License 2.0
1313
url: 'http://www.apache.org/licenses/LICENSE-2.0'
14-
x-conformance-classes: [ "https://api.stacspec.org/v1.0.0-rc.2/collections" ]
14+
x-conformance-classes: ['https://api.stacspec.org/v1.0.0-rc.3/collections']
1515
tags:
1616
- name: Core
1717
description: essential characteristics of a STAC API
@@ -46,7 +46,7 @@ paths:
4646
title: Copernicus Sentinel Imagery
4747
description: Catalog of Copernicus Sentinel 1 and 2 imagery.
4848
conformsTo:
49-
- 'https://api.stacspec.org/v1.0.0-rc.2/core'
49+
- 'https://api.stacspec.org/v1.0.0-rc.3/core'
5050
- 'http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/core'
5151
- 'http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/oas30'
5252
- 'http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/geojson'

ogcapi-features/openapi-features.yaml

+5-4
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
openapi: 3.0.3
22
info:
33
title: STAC API - Features
4-
version: 1.0.0-rc.2
4+
version: 1.0.0-rc.3
55
description: >-
66
This is an OpenAPI definition of the SpatioTemporal Asset Catalog API - Features
77
specification. This extends OGC API - Features - Part 1: Core.
@@ -11,7 +11,8 @@ info:
1111
license:
1212
name: Apache License 2.0
1313
url: 'http://www.apache.org/licenses/LICENSE-2.0'
14-
x-conformance-classes: [ "https://api.stacspec.org/v1.0.0-rc.2/ogcapi-features" ]
14+
x-conformance-classes:
15+
['https://api.stacspec.org/v1.0.0-rc.3/ogcapi-features']
1516
tags:
1617
- name: Features
1718
description: |-
@@ -45,7 +46,7 @@ paths:
4546
title: Copernicus Sentinel Imagery
4647
description: Catalog of Copernicus Sentinel 1 and 2 imagery.
4748
conformsTo:
48-
- 'https://api.stacspec.org/v1.0.0-rc.2/core'
49+
- 'https://api.stacspec.org/v1.0.0-rc.3/core'
4950
- 'http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/core'
5051
- 'http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/oas30'
5152
- 'http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/geojson'
@@ -99,7 +100,7 @@ paths:
99100
'200':
100101
$ref: '#/components/responses/Collections'
101102
'4XX':
102-
$ref: '../core/commons.yaml#/components/responses/Error'
103+
$ref: '../core/commons.yaml#/components/responses/Error'
103104
'5XX':
104105
$ref: '../core/commons.yaml#/components/responses/Error'
105106
'/collections/{collectionId}':

0 commit comments

Comments
 (0)