Merge pull request #1 from stac-api-extensions/pv/release-1.0.0-rc.2

update version for 1.0.0-rc.2 release

.github/pull_request_template.md

@@ -10,5 +10,4 @@
 **PR Checklist:**
 
 - [ ] This PR has **no** breaking changes.
-- [ ] This PR does not make any changes to the core spec in the `stac-spec` directory (these are included as a subtree and should be updated directly in [radiantearth/stac-spec](https://github.com/radiantearth/stac-spec))
-- [ ] I have added my changes to the [CHANGELOG](https://github.com/radiantearth/stac-api-spec/blob/main/CHANGELOG.md) **or** a CHANGELOG entry is not required.
+- [ ] I have added my changes to the [CHANGELOG](https://github.com/stac-api-extensions/children/blob/main/CHANGELOG.md) **or** a CHANGELOG entry is not required.

CHANGELOG.md

@@ -4,201 +4,27 @@ 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).
 
-## [v1.0.0-rc.1] - 2022-03-17
+## [v1.0.0-rc.2] - TBD
 
-### Added
+None
 
-- The CQL2 Accent and Case-insensitive Comparison 
-    (`http://www.opengis.net/spec/cql2/1.0/conf/accent-case-insensitive-comparison`) conformance class
-    adds the ACCENTI and CASEI functions for case-insensitive comparison. These replace the UPPER and
-    LOWER psuedo-functions that were previously part of the Advanced Comparison Operators class.
+## [v1.0.0-rc.1] - 2022-03-17
 
 ### Changed
 
-- Query Extension is no longer deprecated.
 - Children conformance class now requires the /children endpoint includes all child catalogs or collections
   referenced via `child` link relations from the Landing Page
-- Clarified behavior of Transaction Extension endpoints:
-  - PUT and PATCH of a body that changes the `collection` or `id` is disallowed.
-  - POST, PUT, and PATCH do not need to include the `collection` attribute, as it should be derived from the URL.
-  - POST and PUT can be used with a body that is at least a GeoJSON Feature, but does not have to be an Item, but for which 
-    the server can derive a valid Item, e.g., by populating the id and collection fields or adding links
-  - Likewise, POST can be used with a body of a FeatureCollection that contains features that meet the same constraints.
 - Specifications now use the term "must" instead of "shall". The semantics of these words are identical.
-- Conformance class for Item Search Filter is now
-  `https://api.stacspec.org/v1.0.0-beta.5/item-search#filter`, whereas before it was incorrectly stated as
-  `https://api.stacspec.org/v1.0.0-beta.5/item-search#filter:item-search-filter`
-
-### Deprecated
-
-### Removed
-
-### Fixed
 
 ## [v1.0.0-beta.5] - 2022-01-14
 
 ### Added
 
-- Added `STAC API - Browseable` conformance class
 - Added `STAC API - Children` conformance class
-- Added description of how to support both search and browse in an API.
-- The paging mechanism via a Link with rel `next` or `prev` as defined for Item Search can also be used
-  for the STAC API - Features endpoint `/collections/{collection_id}/items`, as described in OAFeat.
-- The paging mechanism via a Link with rel `next` or `prev` as defined for items can also be used
-  for the STAC API - Features and STAC API - Collections endpoint `/collections`.
-
-### Changed
-
-- Limit parameter semantics now match OAFeat. Previously, the behavior was not precisely defined.
-- Filter Extension updates to align with changes to OAFeat CQL2 spec
-  - Updated all "CQL" usages to "CQL2"
-  - Most conformance class URIs are now prefixed with `http://www.opengis.net/spec/cql2/` instead
-    of `http://www.opengis.net/spec/ogcapi-features-3/`
-  - Conformance classes `http://www.opengis.net/spec/ogcapi-features-3/1.0/conf/basic-cql`,
-    `http://www.opengis.net/spec/ogcapi-features-3/1.0/conf/cql-text`, and
-    `http://www.opengis.net/spec/ogcapi-features-3/1.0/conf/cql-json` have had `cql` replaced
-    with `cql2` (in addition to the prefix change) to
-    become `http://www.opengis.net/spec/cql2/1.0/conf/basic-cql2`,
-    `http://www.opengis.net/spec/cql2/1.0/conf/cql2-text`, and
-    `http://www.opengis.net/spec/cql2/1.0/conf/cql2-json`
-  - Significant changes to CQL2 JSON format, now using `op` and `args` structure
-  - Spatial operator `INTERSECTS` is now `S_INTERSECTS`
-  - Temporal operator `ANYINTERACTS` is now `T_INTERSECTS`
-  - Updated Example 3 (now Example 5) to make it clear that property to property comparisons require the
-    Property-Property Comparisons conformance class
-  - The CQL2 Case-insensitive Comparison
-    (`http://www.opengis.net/spec/cql2/1.0/conf/case-insensitive-comparison`) conformance class
-    that adds UPPER/LOWER terms or function CASEI for case-insensitive comparison has not been added
-    to this spec yet, since the definition in CQL2 is in flux.
-- `service-desc` endpoint may return any service description format, typically a
-  machine-consumable one (previous restricted required to be OpenAPI 3.0 JSON)
-- `service-doc` endpoint may return any service description format, typically a
-  human-consumable one (previous restricted required to be HTML)
-
-### Deprecated
-
-### Removed
-
-### Fixed
-
-- Collection conformance class URI should be `https://api.stacspec.org/v1.0.0-beta.XXX/collections` instead
-  of `http://stacspec.org/spec/api/1.0.0-beta.XXX/extensions/collections`
-- definition of Item object was missing `properties` as an attribute
-- Filter Extension - examples of using intervals and timestamps in CQL2 were incorrect and have been fixed
-- Filter Extension - examples are updated so that text and json examples are equivalent
-
-## [v1.0.0-beta.4] - 2021-10-05
-
-### Added
-
-- Support binding Sort, Fields, and Context Extensions to STAC Features items resource
-  endpoint (`/collections/{collectionId}/items`)
-- In Collections, added `canonical` rel type, added `/` and `/api` to list of endpoints
-- In Item Search, added endpoint table
-
-### Changed
-
-- Filter Extension - query language is now referred to as "CQL2" rather than CQL
-- Filter Extension now uses OAFeat Part 3 conformance class URIs
-- Filter Extension - The following changes have been made to the Filter Extension conformance classes to align with changes to the OAFeat CQL draft. All classes
-  whose names have changed also have changed conformance URI strings.
-  - "Basic CQL" now includes the "not equal" operator (`<>`)
-  - "Basic CQL" has always supported datetime comparisons, but this is now explicitly mentioned
-  - "Enhanced Comparison Operators" has been renamed "Advanced Comparison Operators". This is the same as the OAFeat CQL definition, except
-    that it does not require the `upper` and `lower` functions.
-  - "Enhanced Spatial Operators" has been renamed to just "Spatial Operators" (not to be confused with Basic Spatial Operators)
-  - "Basic Temporal Operators" and "Enhanced Temporal Operators" have merged into "Temporal Operators"
-  - "Functions" has been renamed "Custom Functions"
-  - "Arithmetic" has been renamed "Arithmetic Expressions"
-  - "Arrays" has been renamed "Array Operators"
-  - "Queryable Second Operand" has been renamed "Property-Property Comparisons"
-- The required Link Relations and endpoints for each conformance class now use the wording of 'shall'
-  instead of 'should'. While this technically changes the semantics, it was generally understood
-  previously the semantics were those of 'shall' (must).
-- Explicitly state that the `/children` endpoint can return Catalog and Collection objects that have fewer
-  fields than are available through other endpoints.
-
-### Deprecated
-
-### Removed
-
-### Fixed
-
-## [v1.0.0-beta.3] - 2021-08-06
-
-### Added
-- Added STAC API - Collections definition (subset of STAC API - Features)
-- More thorough definitions for valid `datetime` and `bbox` query parameter values.
-
-### Changed
-- Query extension not deprecated; recommendation to use Filter (https://github.com/radiantearth/stac-api-spec/pull/157)
-- Filter Extension conformance classes refactored to better align with STAC API use cases.
-- Renamed conformance class "Queryable First Operand"
-  (https://api.stacspec.org/v1.0.0-beta.3/item-search#filter:queryable-first-operand) to
-  "Queryable Second Operand"
-  (https://api.stacspec.org/v1.0.0-beta.3/item-search#filter:queryable-second-operand)
-
-### Deprecated
-
-### Removed
-- Remove stac_version and stac_extensions fields in ItemCollection
-
-### Fixed
-
-## [v1.0.0-beta.2] - 2021-06-01
-
-### Added
-- Added Filter extension to integrate OAFeat Part 3 CQL
-- Catalog and Collection definitions now have required field "type"
-- Added recommendation to enable CORS for public APIs
-
-### Changed
-- Updated all STAC versions to 1.0.0
-- Passing the `ids` parameter to an item search does not deactivate other query parameters [#125](https://github.com/radiantearth/stac-api-spec/pull/125)
-- The first extent in a Collection is always the overall extent, followed by more specific extents. [opengeospatial/ogcapi-features#520](https://github.com/opengeospatial/ogcapi-features/pull/520)
-
-### Deprecated
-- Query extension is now deprecated. Replaced by the Filter extension using OGC CQL.
-
-### Removed
-
-### Fixed
-- Updated text description of root ('/') endpoint (also called landing page) that the return type is a Catalog
-
-## [v1.0.0-beta.1] - 2020-12-10
-
-### Added
-- The landing page returns the conformance classes in a property `conformsTo`, which mirrors `GET /conformances` from OGC APIs.
-- Conformance classes for all the major functionality and extensions, to be referenced in a new `conformsTo` JSON object in the landing page.
-- Fragments: reusable OpenAPI documents for sort, filter, fields and context, along with explanation of how they work.
-- ItemCollection moved from [STAC Core](https://github.com/radiantearth/stac-spec/blob/v0.9.0/item-spec/itemcollection-spec.md) to this repo.
-
-### Changed
-- Major re-organization of the content and directory structure to make better conformance classes.
-  - STAC API Core is the landing page (a STAC catalog and conformance information).
-  - Item Search is the `search` cross-collection item search resource.
-  - STAC API - Features is the OGC API - Features standards to be used in a STAC API.
-  - Extensions are specified in the relevant functionality directory, though they can share openapi yaml's in the 'fragments' directory.
-- Updated to STAC specification version 1.0.0-beta.2
-- Named explicit supported STAC core versions to be from 0.9.0 up to (and not including) 2.0.0
-- Context Extension OpenAPI spec was updated to remove the no longer used `next` attribute
-- Added root endpoint Link `search` must have `type` of `application/geo+json`
-- Corrected the description of endpoint `/collections` to say it returns an object per OAFeat, instead of an array of Collection
-- Updated transaction extension so it aligns with OGC API - Features Part 4: Simple Transactions
-
-### Deprecated
-
-### Removed
-
-### Fixed
-- BBOX openapi yaml to only allow 4 or 6 element arrays
-- Fixed invalid OpenAPI files
 
 ## Older versions
 
-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/master...dev>
-[v1.0.0-beta.1]: <https://github.com/radiantearth/stac-api-spec/tree/v1.0.0-beta.1>
-[v1.0.0-beta.2]: <https://github.com/radiantearth/stac-api-spec/tree/v1.0.0-beta.2>
+[Unreleased]: <https://github.com/stac-api-extensions/children/compare/v1.0.0-rc.2..main>
+[v1.0.0-rc.2]: <https://github.com/stac-api-extensions/children/tree/v1.0.0-rc.2>
+[v1.0.0-rc.1]: <https://github.com/stac-api-extensions/children/tree/v1.0.0-rc.1>
+[v1.0.0-beta.5]: <https://github.com/radiantearth/stac-api-spec/tree/v1.0.0-beta.2>

README.md

@@ -1,11 +1,11 @@
 # STAC API - Children Extension
 
-- **OpenAPI specification:** [openapi.yaml](openapi.yaml) ([rendered version](https://api.stacspec.org/v1.0.0-rc.1/children))
+- **OpenAPI specification:** [openapi.yaml](openapi.yaml) ([rendered version](https://api.stacspec.org/v1.0.0-rc.2/children))
 - **Conformance Classes:** 
-  - <https://api.stacspec.org/v1.0.0-rc.1/children>
-- **[Maturity Classification](https://github.com/radiantearth/stac-api-spec/tree/v1.0.0-rc.1/README.md#maturity-classification):** Proposal
+  - <https://api.stacspec.org/v1.0.0-rc.2/children>
+- **[Maturity Classification](https://github.com/radiantearth/stac-api-spec/tree/v1.0.0-rc.2/README.md#maturity-classification):** Proposal
 - **Dependencies**:
-  - [STAC API - Core](https://github.com/radiantearth/stac-api-spec/tree/v1.0.0-rc.1/core)
+  - [STAC API - Core](https://github.com/radiantearth/stac-api-spec/tree/v1.0.0-rc.2/core)
 
 - [STAC API - Children Extension](#stac-api---children-extension)
   - [Link Relations](#link-relations)
@@ -28,7 +28,7 @@ but the objects must still be valid Catalogs and Collections.
 ## Link Relations
 
 This conformance class also requires implementation of the link relations in the
-[STAC API - Core](https://github.com/radiantearth/stac-api-spec/tree/v1.0.0-rc.1/core) conformance class.
+[STAC API - Core](https://github.com/radiantearth/stac-api-spec/tree/v1.0.0-rc.2/core) conformance class.
 
 The following Link relations must exist in the Landing Page (root).
 
@@ -46,7 +46,7 @@ The following Link relations must exist in the `/children` endpoint response.
 ## Endpoints
 
 This conformance class also requires for the endpoints in the
-[STAC API - Core](https://github.com/radiantearth/stac-api-spec/tree/v1.0.0-rc.1/core) conformance class to be implemented.
+[STAC API - Core](https://github.com/radiantearth/stac-api-spec/tree/v1.0.0-rc.2/core) conformance class to be implemented.
 
 | Endpoint    | Returns | Description                                          |
 | ----------- | ------- | ---------------------------------------------------- |
@@ -60,7 +60,7 @@ array of Links in a field `links`.
 
 The `/children` endpoint supports a pagination mechanism that aligns with pagination as described in the 
 OGC API - Common - Part 2: Geospatial Data specification. This is described in detail in
-the [STAC - Features Collection Pagination section](https://github.com/radiantearth/stac-api-spec/tree/v1.0.0-rc.1/ogcapi-features/README.md#collection-pagination).
+the [STAC - Features Collection Pagination section](https://github.com/radiantearth/stac-api-spec/tree/v1.0.0-rc.2/ogcapi-features/README.md#collection-pagination).
 To the greatest extent possible, the catalog should be structured such that all children can be
 retrieved from the endpoint in a single call.
 
@@ -82,9 +82,9 @@ The STAC API Landing Page should look like the following (note the `child` link
   "description": "This Catalog aims to demonstrate the a simple landing page",
   "type": "Catalog",
   "conformsTo": [
-    "https://api.stacspec.org/v1.0.0-rc.1/core",
-    "https://api.stacspec.org/v1.0.0-rc.1/children",
-    "https://api.stacspec.org/v1.0.0-rc.1/browseable"
+    "https://api.stacspec.org/v1.0.0-rc.2/core",
+    "https://api.stacspec.org/v1.0.0-rc.2/children",
+    "https://api.stacspec.org/v1.0.0-rc.2/browseable"
   ],
   "links": [
     {

openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: STAC API - Children
-  version: '1.0.0-rc.1'
+  version: '1.0.0-rc.2'
   description: >-
     This is an OpenAPI definition of the SpatioTemporal Asset Catalog API - Children
     specification.
@@ -36,16 +36,16 @@ paths:
           content:
             application/json:
               schema:
-                $ref: 'https://api.stacspec.org/v1.0.0-rc.1/core/openapi.yaml#/components/schemas/landingPage'
+                $ref: 'https://api.stacspec.org/v1.0.0-rc.2/core/openapi.yaml#/components/schemas/landingPage'
               example:
                 stac_version: '1.0.0'
                 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-rc.1/core'
-                  - 'https://api.stacspec.org/v1.0.0-rc.1/children'
+                  - 'https://api.stacspec.org/v1.0.0-rc.2/core'
+                  - 'https://api.stacspec.org/v1.0.0-rc.2/children'
                   - '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'
@@ -92,13 +92,13 @@ components:
         - children
       properties:
         links:
-          $ref: 'https://api.stacspec.org/v1.0.0-rc.1/ogcapi-features/openapi.yaml#/components/schemas/links'
+          $ref: 'https://api.stacspec.org/v1.0.0-rc.2/ogcapi-features/openapi.yaml#/components/schemas/links'
         children:
           type: array
           items:
             anyOf:
-              - $ref: 'https://api.stacspec.org/v1.0.0-rc.1/ogcapi-features/openapi.yaml#/components/schemas/catalog'
-              - $ref: 'https://api.stacspec.org/v1.0.0-rc.1/ogcapi-features/openapi.yaml#/components/schemas/collection'
+              - $ref: 'https://api.stacspec.org/v1.0.0-rc.2/ogcapi-features/openapi.yaml#/components/schemas/catalog'
+              - $ref: 'https://api.stacspec.org/v1.0.0-rc.2/ogcapi-features/openapi.yaml#/components/schemas/collection'
   responses:
     Children:
       description: |-
@@ -113,4 +113,4 @@ components:
       content:
         application/json:
           schema:
-            $ref: 'https://api.stacspec.org/v1.0.0-rc.1/ogcapi-features/openapi.yaml#/components/schemas/exception'
+            $ref: 'https://api.stacspec.org/v1.0.0-rc.2/ogcapi-features/openapi.yaml#/components/schemas/exception'

package.json

@@ -1,6 +1,6 @@
 {
     "name": "api-spec",
-    "version": "1.0.0-rc.1",
+    "version": "1.0.0-rc.2",
     "description": "STAC API helpers to generate, serve and check the API spec.",
     "repository": "https://github.com/radiantearth/stac-api-spec",
     "license": "Apache-2.0",
@@ -91,4 +91,4 @@
             ]
         ]
     }
-}
+}