Renamed according to PR review

Author: m-mohr

extensions/processing-parameters/README.md

@@ -1,6 +1,6 @@
 # Processing Parameters Extension
 
-The Processing Parameters Extension to the openEO API provides an interface to explore and handle additional processing options that a back-end can offer for the three processing modes (synchronous processing, batch jobs, secondary web services).
+The Processing Parameters Extension to the openEO API provides an interface to explore and handle additional processing parameters that a back-end can offer for the three processing modes (synchronous processing, batch jobs, secondary web services).
 
 - Version: **0.1.0**
 - Stability: **experimental**
@@ -10,8 +10,8 @@ The Processing Parameters Extension to the openEO API provides an interface to e
 **Note:** This document only documents the additions to the specification.
 Extensions can not change or break existing behavior of the openEO API.
 
-This extension adds a new endpoint (`GET /processing_options`, see [OpenAPI document](openapi.yaml))
-to discover the additional processing options that a back-end offers.
+This extension adds a new endpoint (`GET /processing_parameters`, see [OpenAPI document](openapi.yaml))
+to discover the additional processing parameters that a back-end offers.
 
 Additionally, this extension allows to provide specific default values for user-defined processes (UDPs, see below).
 
@@ -21,12 +21,12 @@ In both cases, the parameters and its values are provided separately for each pr
 
 UDPs can provide default values for specific processing parameters.
 
-The values for each parameter are provided  separately for each processing mode.
+The values for each parameter (so called 'options') are provided separately for each processing mode.
 The following properties are added to the top-level of a UDP for the respective processing modes:
 
-- `default_synchronous_parameters` for synchronous processing
-- `default_job_parameters` for batch jobs
-- `default_service_parameters` for secondary web services
+- `default_synchronous_options` for synchronous processing
+- `default_job_options` for batch jobs
+- `default_service_options` for secondary web services
 
 The schema for each of these properties is:
 
@@ -38,7 +38,7 @@ additionalProperties:
 
 The keys of the object are the respective parameter names.
 The values of the object are the default values for the parameters.
-Schematic restrictions are not defined for the object, but the schemas for the parameters as defined in `GET /processing_options` apply to the given values.
+Schematic restrictions are not defined for the object, but the schemas for the parameters as defined in `GET /processing_parameters` apply to the given values.
 These values provide the defaults unless a user overrides them in the actual data processing request (e.g. `POST /jobs`, see below).
 
 ## Resolving parameters
@@ -48,7 +48,7 @@ list defines how the parameters must be resolved. The prioritization is as follo
 
 1. If present, use the parameter specified in the processing request directly (e.g. in `POST /jobs` as a top-level property)
 2. If present, use the default parameter specified in the UDP
-3. Otherwise, use the default value for the parameter as specified in `GET /processing_options`
+3. Otherwise, use the default value for the parameter as specified in `GET /processing_parameters`
 
 "Present" means that the property is present in the JSON representation regardless of the value given, i.e.
 properties are present if an empty string, an empty array, an empty object, `false`, `0`, or `null` are provided.

extensions/processing-parameters/openapi.yaml

@@ -3,7 +3,7 @@ info:
   title: openEO API - Processing Parameters Extension
   version: 0.1.0
   description: >-
-    The Processing Parameters Extension to the openEO API provides an interface to explore and handle additional processing options that a back-end can offer for the three processing modes (synchronous processing, batch jobs, and secondary web services).
+    The Processing Parameters Extension to the openEO API provides an interface to explore and handle additional processing parameters that a back-end can offer for the three processing modes (synchronous processing, batch jobs, and secondary web services).
     The openEO API specification allows back-ends to accept "additional back-end specific properties" for each of the processing modes.
     As the openEO API specification does not define the name and schemas of these properties, this extension provides a standardized way to define and document these properties.
   contact:
@@ -44,15 +44,15 @@ servers:
           the version number of the API. Use the version number returned from
           `GET /` instead.
 paths:
-  /processing_options:
+  /processing_parameters:
     get:
-      summary: Additional processing options
-      operationId: list-processing-options
+      summary: Additional processing parameters
+      operationId: list-processing-parameters
       description: |-
-        Lists additional custom processing options
+        Lists additional custom processing parameters
         that a back-end offers for the different processing modes (synchronous processing, batch jobs, secondary web services).
-        The options specified here can be added to the corresponding `POST` requests at the top-level of the object that is sent as the payload.
-        All options SHOULD explicitly be made optional with reasonable defaults as otherwise the interoperability between the implementations decreases.
+        The parameters specified here can be added to the corresponding `POST` requests at the top-level of the object that is sent as the payload.
+        All parameters SHOULD explicitly be made optional with reasonable defaults as otherwise the interoperability between the implementations decreases.
       tags:
         - Capabilities
         - Data Processing