[ML] Adds description to the DELETE DFA API spec (#538)

* [ML] Adds description to the DELETE DFA API spec.

* [ML] Updates schema.

Author: szabosteve

output/schema/schema.json

@@ -107706,6 +107706,7 @@
       },
       "path": [
         {
+          "description": "Identifier for the data frame analytics job.",
           "name": "id",
           "required": true,
           "type": {
@@ -107719,6 +107720,7 @@
       ],
       "query": [
         {
+          "description": "If `true`, it deletes a job that is not stopped; this method is quicker than stopping and deleting the job.",
           "name": "force",
           "required": false,
           "serverDefault": false,
@@ -107731,6 +107733,7 @@
           }
         },
         {
+          "description": "The time to wait for the job to be deleted.",
           "name": "timeout",
           "required": false,
           "serverDefault": "1m",

specification/ml/delete_data_frame_analytics/MlDeleteDataFrameAnalyticsRequest.ts

@@ -28,12 +28,21 @@ import { Time } from '@_types/Time'
  */
 export interface Request extends RequestBase {
   path_parts?: {
+    /**
+     * Identifier for the data frame analytics job.
+     */
     id: Id
   }
   query_parameters?: {
-    /** @server_default false */
+    /**
+     * If `true`, it deletes a job that is not stopped; this method is quicker than stopping and deleting the job.
+     * @server_default false
+     */
     force?: boolean
-    /** @server_default 1m */
+    /**
+     * The time to wait for the job to be deleted.
+     * @server_default 1m
+     */
     timeout?: Time
   }
 }