fix(specs): Add title values to key oneOfs (#5581)

Co-authored-by: Gary Conroy <gary.conroy@LON-M3P-GConroy.local>
Co-authored-by: Pierre Millot <pierre.millot@algolia.com>

Author: 3 people

specs/abtesting-v3/common/schemas/AddABTestsVariant.yml

@@ -1,8 +1,9 @@
 AddABTestsVariant:
   oneOf:
-    - $ref: '#/abTestsVariant'
-    - $ref: '#/abTestsVariantSearchParams'
-
+    - title: Variant
+      $ref: '#/abTestsVariant'
+    - title: Variant with search parameters
+      $ref: '#/abTestsVariantSearchParams'
 abTestsVariantSearchParams:
   allOf:
     - $ref: '#/abTestsVariant'

specs/abtesting/common/schemas/AddABTestsVariant.yml

@@ -1,7 +1,9 @@
 AddABTestsVariant:
   oneOf:
-    - $ref: '#/abTestsVariant'
-    - $ref: '#/abTestsVariantSearchParams'
+    - title: Variant
+      $ref: '#/abTestsVariant'
+    - title: Variant with search parameters
+      $ref: '#/abTestsVariantSearchParams'
 
 abTestsVariantSearchParams:
   allOf:

specs/composition/common/schemas/requestBodies/BatchCompositionAction.yml

@@ -10,5 +10,7 @@ deleteCompositionAction:
 
 batchCompositionAction:
   oneOf:
-    - $ref: '../components/Composition.yml#/composition'
-    - $ref: '#/deleteCompositionAction'
+    - title: Upsert (update and insert)
+      $ref: '../components/Composition.yml#/composition'
+    - title: Delete
+      $ref: '#/deleteCompositionAction'

specs/composition/common/schemas/requestBodies/RulesBatchCompositionAction.yml

@@ -10,5 +10,7 @@ deleteCompositionRuleAction:
 
 rulesBatchCompositionAction:
   oneOf:
-    - $ref: '../components/CompositionRule.yml#/compositionRule'
-    - $ref: '#/deleteCompositionRuleAction'
+    - title: Upsert (update and insert)
+      $ref: '../components/CompositionRule.yml#/compositionRule'
+    - title: Delete
+      $ref: '#/deleteCompositionRuleAction'

specs/composition/paths/compositions/composition.yml

@@ -32,9 +32,9 @@ put:
   operationId: putComposition
   x-acl:
     - editSettings
-  summary: Upsert a composition
+  summary: Update and insert (upsert) a composition
   description: |
-    Upsert a composition in the current Algolia application.
+    Update and insert a composition in the current Algolia application.
   parameters:
     - $ref: '../urlParams.yml#/compositionID'
   requestBody:

specs/ingestion/common/schemas/task.yml

@@ -509,6 +509,7 @@ MappingInput:
     - actions
 
 StreamingInput:
+  title: Streaming input
   type: object
   additionalProperties: false
   description: Input for a `streaming` task whose source is of type `ga4BigqueryExport` and for which extracted data is continuously streamed.
@@ -521,6 +522,7 @@ StreamingInput:
     - mapping
 
 DockerStreamsInput:
+  title: Docker streams
   description: The selected streams of an airbyte connector.
   type: object
   properties:
@@ -562,6 +564,7 @@ failureThreshold:
   description: Maximum accepted percentage of failures for a task run to finish successfully.
 
 ShopifyInput:
+  title: Shopify input
   type: object
   additionalProperties: false
   description: Represents the required elements of the task input when using a `shopify` source.

specs/ingestion/common/schemas/transformation.yml

@@ -43,6 +43,7 @@ TransformationInput:
     - $ref: '#/TransformationNoCode'
 
 TransformationCode:
+  title: Code
   type: object
   additionalProperties: false
   description: Input for a transformation that contains the source code of the transformation.
@@ -54,6 +55,7 @@ TransformationCode:
     - code
 
 TransformationNoCode:
+  title: No-code
   type: object
   additionalProperties: false
   description: Input for a no-code transformation that contains a series of steps.

specs/recommend/common/schemas/RecommendationsResponse.yml

@@ -45,6 +45,7 @@ recommendHit:
 
 trendingFacetHit:
   type: object
+  title: Trending facet hit
   description: Trending facet hit.
   required:
     - facetName