Reference parameter defs in the text rather than copy.

Author: pvretano

core/openapi/ogcapi-records-1-example-ref-schema-repo.yaml

@@ -169,7 +169,7 @@ paths:
         - $ref: 'parameters/catalogId.yaml'
         - $ref: 'parameters/q.yaml'
         - $ref: 'parameters/type.yaml'
-        - $ref: 'parameters/externalId.yaml'
+        - $ref: 'parameters/externalIds.yaml'
         - $ref: 'parameters/ids.yaml'
         - $ref: 'parameters/sortby.yaml'
       responses:

core/openapi/parameters/externalId.yaml

@@ -0,0 +1,16 @@
+---
+name: externalIds
+in: query
+description: |-
+  The optional externalIds parameter allows a specific list of records,
+  identified by their external identifiers, to be fetched from a catalog.
+  Only records where one of their associated external identifiers equals
+  one of the values listed for this parameter shall appear in the response.
+required: false
+schema:
+  type: array
+  items:
+    type: string
+    pattern: ([^:]+:)?[^:]+
+explode: false
+style: form

core/openapi/parameters/externalIds.yaml

@@ -2,8 +2,10 @@
 name: ids
 in: query
 description: 
-  The optional ids parameter allows a specified of records to be fetched
-  from a catalog using their identifiers.
+  The optional ids parameter allows a specific list of records, identified
+  by their identifiers, to be fetched from a catalog.  Only records whose
+  identifier matches one of the values listed for this parameter shall appear
+  in the response.
 required: false
 schema:
   type: array

core/openapi/parameters/ids.yaml

@@ -5,7 +5,7 @@ description: |-
   The optional q parameter supports keyword searching.  Only records
   whose text fields contain one or more of the specified search terms
   are selected.  The specific set of text keys/fields/properties of a
-  record to which the q operator is applied is up to the description
+  record to which the q operator is applied is up to the discretion
   of the server.   Implementations should, however, apply the q
   operator to the title, description and keywords keys/fields/properties.
 required: false

core/openapi/parameters/q.yaml

@@ -2,13 +2,16 @@
 name: type
 in: query
 description: |-
-  The optional type parameter supports searching by resource type.  Only
-  records whose type, as indicated by the value of the type core
-  queryable, is equal to one of the listed values shall be selected.
+  The optional type parameter allows a specific list of records, identified
+  by their resource type, to be fetched from a catalog.  Only records whose
+  resource type matches one of the values listed for this parameter shall
+  appear in the response.
 required: false
 schema:
   type: array
   items:
     type: string
 explode: false
 style: form
+
+

core/openapi/parameters/type.yaml

@@ -30,15 +30,7 @@ part:: The `externalIds` parameter SHALL have the following characteristics (usi
 +
 [source,YAML]
 ----
-name: externalIds
-in: query
-required: false
-schema:
-  type: array
-  items:
-    type: string
-    pattern: ([^:]+:)?[^:]+
-explode: false
+include::../../../../openapi/parameters/externalIds.yaml[]
 ----
 
-====
+====

core/standard/requirements/building-blocks/record-core-query-parameters/REQ_query-param-externalIds-definition.adoc

@@ -32,14 +32,7 @@ part:: The following OpenAPI 3.0 schema fragment SHALL define the characteristic
 +
 [source,YAML]
 ----
-name: ids
-in: query
-required: false
-schema:
-  type: array
-  items:
-    type: string
-explode: false
-style: form
+include::../../../../openapi/parameters/ids.yaml[]
 ----
+
 ====

core/standard/requirements/building-blocks/record-core-query-parameters/REQ_query-param-ids-definition.adoc

@@ -34,15 +34,7 @@ part:: The `q` parameter SHALL have the following characteristics (using an Open
 +
 [source,YAML]
 ----
-name: q
-in: query
-required: false
-schema:
-  type: array
-  items:
-    type: string
-explode: false
-style: form
+include::../../../../openapi/parameters/q.yaml[]
 ----
 
 part:: Search terms that may appear together (logical OR) in a record SHALL be separated by literal commas.

core/standard/requirements/building-blocks/record-core-query-parameters/REQ_query-param-q-definition.adoc

@@ -30,14 +30,7 @@ part:: The `type` parameter SHALL have the following characteristics (using an O
 
 [source,YAML]
 ----
-name: type
-in: query
-required: false
-schema:
-  type: array
-  items:
-    type: string
-explode: false
-style: form
+include::../../../../openapi/parameters/type.yaml[]
 ----
+
 ====