openAPI: Clarified purpose of /api/* paths to avoid confusion

opengeospatial · Sep 7, 2023 · 5d85cf9 · 5d85cf9
1 parent cb46722
commit 5d85cf9
Show file tree

Hide file tree

Showing 4 changed files with 6 additions and 6 deletions.
diff --git a/standard/openapi/ogcapi-coverages-1.bundled.json b/standard/openapi/ogcapi-coverages-1.bundled.json
@@ -102,7 +102,7 @@
           "API"
         ],
         "operationId": "getAPICollections",
-        "summary": "Retrieve the list of collections available from this API implementation & deployment.",
+        "summary": "JSON enumeration of all the collections available from this API implementation & deployment (for inclusion in the API definition).",
         "parameters": [
           {
             "$ref": "#/components/parameters/f-metadata"
@@ -130,7 +130,7 @@
           "API"
         ],
         "operationId": "getAPICoverageCollections",
-        "summary": "Retrieve the list of coverages collections available from this API implementation & deployment.",
+        "summary": "JSON enumeration of the coverage collections available from this API implementation & deployment (for inclusion in the API definition).",
         "parameters": [
           {
             "$ref": "#/components/parameters/f-metadata"
@@ -158,7 +158,7 @@
           "API"
         ],
         "operationId": "getAPITileMatrixSets",
-        "summary": "Retrieve the list of shared TileMatrixSets available from this API implementation & deployment.",
+        "summary": "JSON enumeration of the shared TileMatrixSets available from this API implementation & deployment (for inclusion in the API definition).",
         "parameters": [
           {
             "$ref": "#/components/parameters/f-metadata"

diff --git a/standard/openapi/paths/dynamic/pAllCollections.yaml b/standard/openapi/paths/dynamic/pAllCollections.yaml
@@ -3,7 +3,7 @@ get:
    tags:
      - API
    operationId: getAPICollections
-   summary: Retrieve the list of collections available from this API implementation & deployment.
+   summary: JSON enumeration of all the collections available from this API implementation & deployment (for inclusion in the API definition).
    parameters:
      - $ref: '../../parameters/unspecified/f-metadata.yaml'
    responses:

diff --git a/standard/openapi/paths/dynamic/pCoverageCollections.yaml b/standard/openapi/paths/dynamic/pCoverageCollections.yaml
@@ -3,7 +3,7 @@ get:
    tags:
      - API
    operationId: getAPICoverageCollections
-   summary: Retrieve the list of coverages collections available from this API implementation & deployment.
+   summary: JSON enumeration of the coverage collections available from this API implementation & deployment (for inclusion in the API definition).
    parameters:
      - $ref: '../../parameters/unspecified/f-metadata.yaml'
    responses:

diff --git a/standard/openapi/paths/dynamic/pTileMatrixSets.yaml b/standard/openapi/paths/dynamic/pTileMatrixSets.yaml
@@ -3,7 +3,7 @@ get:
    tags:
      - API
    operationId: getAPITileMatrixSets
-   summary: Retrieve the list of shared TileMatrixSets available from this API implementation & deployment.
+   summary: JSON enumeration of the shared TileMatrixSets available from this API implementation & deployment (for inclusion in the API definition).
    parameters:
      - $ref: '../../parameters/unspecified/f-metadata.yaml'
    responses: