Stop reading docUrl, docTag, extDocUrl, requestBodyRequired and availability from rest-api-spec

Author: pquentin

compiler/src/model/build-model.ts

@@ -65,15 +65,9 @@ export function compileEndpoints (jsonSpec: Map<string, JsonSpec>): Record<strin
     map[api] = {
       name: api,
       description: spec.documentation.description,
-      docUrl: spec.documentation.url,
-      docTag: spec.docTag,
-      extDocUrl: spec.externalDocs?.url,
-      // Setting these values by default should be removed
-      // when we no longer use rest-api-spec stubs as the
-      // source of truth for stability/visibility.
-      availability: {},
+      docUrl: null,
       request: null,
-      requestBodyRequired: Boolean(spec.body?.required),
+      requestBodyRequired: false,
       response: null,
       urls: spec.url.paths.map(path => {
         return {
@@ -83,9 +77,7 @@ export function compileEndpoints (jsonSpec: Map<string, JsonSpec>): Record<strin
         }
       })
     }
-    if (typeof spec.feature_flag === 'string') {
-      map[api].availability.stack = { featureFlag: spec.feature_flag }
-    }
+    map[api].availability = {}
   }
   return map
 }

compiler/src/model/json-spec.ts

@@ -30,8 +30,6 @@ export interface JsonSpec {
     url: string
     description: string
   }
-  stability: model.Stability
-  visibility: model.Visibility
   feature_flag?: string
   headers: {
     accept?: string[]
@@ -61,11 +59,6 @@ export interface JsonSpec {
     description: string
     required?: boolean
   }
-  docTag?: string
-  externalDocs?: {
-    url: string
-    description?: string
-  }
 }
 
 export default function buildJsonSpec (): Map<string, JsonSpec> {

output/schema/schema.json

@@ -484,7 +484,7 @@ ml-get-memory,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operat
 ml-get-overall-buckets,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-ml-get-overall-buckets,https://www.elastic.co/guide/en/elasticsearch/reference/8.18/ml-get-overall-buckets.html,
 ml-get-record,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-ml-get-records,https://www.elastic.co/guide/en/elasticsearch/reference/8.18/ml-get-record.html,
 ml-get-snapshot,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-ml-get-model-snapshots,https://www.elastic.co/guide/en/elasticsearch/reference/8.18/ml-get-snapshot.html,
-ml-jobs,https://www.elastic.co/docs/explore-analyze/machine-learning/anomaly-detection/ml-ad-run-jobs,,
+ml-jobs,https://www.elastic.co/guide/en/machine-learning/current/ml-jobs.html,,
 ml-model-snapshots,https://www.elastic.co/docs/explore-analyze/machine-learning/anomaly-detection/ml-ad-run-jobs#ml-ad-model-snapshots,,
 ml-open-job,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-ml-open-job,https://www.elastic.co/guide/en/elasticsearch/reference/8.18/ml-open-job.html,
 ml-post-calendar-event,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-ml-post-calendar-events,https://www.elastic.co/guide/en/elasticsearch/reference/8.18/ml-post-calendar-event.html,

specification/_doc_ids/table.csv

@@ -30,6 +30,7 @@ import { ModelPlotConfig } from '@ml/_types/ModelPlot'
  * @rest_spec_name ml.validate
  * @availability stack since=6.3.0 stability=stable visibility=private
  * @availability serverless stability=stable visibility=private
+ * @doc_id ml-jobs
  * @doc_tag ml anomaly
  */
 export interface Request extends RequestBase {