Release 1.0.0 RC2

Author: m-mohr

CHANGELOG.md

@@ -6,6 +6,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## Unreleased / Draft
 
+## 1.0.0-rc.2 - 2020-02-20
+
 ### Added
 - `PUT /process_graphs/{process_graph_id}` to store and replace custom process-graphs. [#260](https://github.com/Open-EO/openeo-api/issues/260)
 - `/jobs/{job_id}/logs` and `GET /services/{service_id}/logs`: Reintroduced the missing `offset` parameter.

README.md

@@ -2,16 +2,17 @@
 
 openEO develops an open API to connect R, Python and JavaScript clients to big Earth observation cloud back-ends in a simple and unified way. This repository contains this API, the openEO (core) API.
 
-* **[Documentation / Specification](https://api.openeo.org/draft)**
+* **[Latest Version of the Specification](https://api.openeo.org)**
 
-## Versions
+## Versions / Branches
 
-The openEO (core) API is currently released in version **1.0.0-rc.1**. **This branch is an unreleased draft!**
+The [master branch](https://github.com/Open-EO/openeo-api/tree/master) is the 'stable' version of the openEO API specification. It is currently version **1.0.0-rc.2** of the specification. The [draft branch](https://github.com/Open-EO/openeo-api/tree/draft) is where active development takes place.
 
 | Version / Branch                                          | Status      | Description |
 | --------------------------------------------------------- | ----------- | ----------- |
-| [draft](https://api.openeo.org/draft)                     | planned     | Bug fixes based on developer feedback, introduce extension concept. Potentially version 1.0.0-final. |
-| [**1.0.0-rc.1**](https://api.openeo.org)                  | **current** | Release candidate for first stable version of openEO, see the [changelog](CHANGELOG.md#100-rc1---2020-01-31). |
+| [draft](https://api.openeo.org/draft)                     | planned     | *Unstable* - Bug fixes based on developer feedback, introduce extension concept. Potentially version 1.0.0-final. |
+| [**1.0.0-rc.2**](https://api.openeo.org)                  | **current** | Release candidate 2 for first stable version of openEO, see the [changelog](CHANGELOG.md#100-rc2---2020-02-20). |
+| [1.0.0-rc.1](https://api.openeo.org/1.0.0-rc.1)           | legacy      | Release candidate 1 for first stable version of openEO, see the [changelog](CHANGELOG.md#100-rc1---2020-01-31). |
 | [0.4.2](https://api.openeo.org/v/0.4.2)                   | legacy      | Bugfix release, see the [changelog](CHANGELOG.md#042---2019-06-11). |
 | [0.4.1](https://api.openeo.org/v/0.4.1)                   | legacy      | Bugfix release, see the [changelog](CHANGELOG.md#041---2019-05-29). |
 | [0.4.0](https://api.openeo.org/v/0.4.0)                   | legacy      | Improved discovery, added processes catalogue, new process graph structure and [more](CHANGELOG.md#040---2019-03-07). |
@@ -26,7 +27,7 @@ See also the [changelog](CHANGELOG.md) and the [milestones](https://github.com/O
 
 This repository contains a set of files formally describing the openEO API, each with a human-readable and easily browseable version:
 
-* [openapi.yaml](openapi.yaml) ([human-readable version](https://api.openeo.org/draft/)) provides the [openAPI](https://www.openapis.org/) 3.0 definition of the openEO API.
+* [openapi.yaml](openapi.yaml) provides the [OpenAPI](https://www.openapis.org/) 3.0 definition of the openEO API. See the table above for human-readable versions of the OpenAPI definition.
 * [errors.json](errors.json) is a list of potential global error codes and messages, excluding specific exceptions separately available for each process.
 * [subtype-schema.json](subtype-schema.json) defines data types (subtypes) for JSON Schema used in openEO.
 * The [assets](assets/) folder contains some useful additional files such as examples or schemas. All of these are non-binding additions. The source of truth are the top-level specification files.

openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.2
 info:
   title: openEO API
-  version: draft
+  version: 1.0.0-rc.2
   description: |-
     The openEO API specification for interoperable cloud-based processing of large Earth observation datasets.
 
@@ -193,7 +193,7 @@ info:
     A **process** is an operation that performs a specific task on a set of parameters and returns a result. An example is computing a statistical operation, such as mean or median, on selected EO data. A process is similar to a function or method in programming languages. In openEO, processes are used to build a chain of processes ([process graph](#section/Processes/Process-Graphs)), which can be applied to EO data to derive your own findings from the data.
 
     A **pre-defined process** is a process provided by the *back-end*. There is a set of predefined processes by openEO to improve interoperability between back-ends.
-    Back-ends SHOULD follow these specifications whenever possible. Not all processes need to be implemented by all back-ends. See the **[process reference](https://processes.openeo.org/draft)** for pre-defined processes.
+    Back-ends SHOULD follow these specifications whenever possible. Not all processes need to be implemented by all back-ends. See the **[process reference](https://processes.openeo.org)** for pre-defined processes.
 
     A **user-defined process** is a process defined by the *user*. It can directly be part of another process graph or be stored as custom process on a back-end. Internally it is a *process graph* with optional additional metadata.
 
@@ -417,7 +417,7 @@ info:
     url: 'http://www.apache.org/licenses/LICENSE-2.0.html'
 externalDocs:
   description: openEO Documentation
-  url: 'https://openeo.org/documentation/draft/'
+  url: 'https://openeo.org/documentation/1.0'
 tags:
   - name: Capabilities
     description: General information about the API implementation and other supported capabilities at the back-end.

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openeo/api",
-  "version": "1.0.0-draft",
+  "version": "1.0.0-rc.2",
   "author": "openEO Consortium",
   "license": "Apache-2.0",
   "description": "The openEO API specification.",