chore: rename and change spec

Author: cdhawke

specs/abtesting/common/parameters.yml

@@ -137,22 +137,3 @@ filterEffects:
           type: integer
           description: Number of tracked searches removed from the A/B test.
           example: 237
-
-minimumDetectableEffect:
-  type: object
-  properties:
-    durationDays:
-      type: number
-      format: int64
-      description: Estimated number of days needed to reach the sample sizes required for detecting the configured effect. This value is based on historical traffic.
-      example: 21
-    controlSampleSize:
-      type: number
-      format: int64
-      description: Number of tracked searches needed to be able to detect the configured effect for the control variant.
-      example: 23415
-    experimentSampleSize:
-      type: number
-      format: int64
-      description: Number of tracked searches needed to be able to detect the configured effect for the experiment variant.
-      example: 23415

specs/abtesting/common/schemas/EstimateABTestResponse.yml

@@ -0,0 +1,18 @@
+EstimateABTestResponse:
+  type: object
+  properties:
+    durationDays:
+      type: number
+      format: int64
+      description: Estimated number of days needed to reach the sample sizes required for detecting the configured effect. This value is based on historical traffic.
+      example: 21
+    controlSampleSize:
+      type: number
+      format: int64
+      description: Number of tracked searches needed to be able to detect the configured effect for the control variant.
+      example: 23415
+    experimentSampleSize:
+      type: number
+      format: int64
+      description: Number of tracked searches needed to be able to detect the configured effect for the experiment variant.
+      example: 23415

specs/abtesting/common/schemas/EstimateResponse.yml

@@ -11,14 +11,14 @@ post:
     content:
       application/json:
         schema:
-          title: estimateRequest
+          title: estimateABTestRequest
           type: object
           additionalProperties: false
           properties:
             configuration:
-              title: configuration
+              title: estimateConfiguration
               type: object
-              description: A/B test configuration.
+              description: A/B test configuration for estimating the sample size and duration using minimum detectable effect.
               properties:
                 outliers:
                   $ref: '../common/schemas/ABTest.yml#/Outliers'
@@ -51,7 +51,7 @@ post:
       content:
         application/json:
           schema:
-            $ref: '../common/schemas/EstimateResponse.yml#/EstimateResponse'
+            $ref: '../common/schemas/EstimateABTestResponse.yml#/EstimateABTestResponse'
     '400':
       $ref: '../../common/responses/BadRequest.yml'
     '402':