[DOCS] Fine-tunes data frame analytics API docs formatting. (#50799)

docs/reference/ml/df-analytics/apis/delete-dfanalytics.asciidoc

@@ -21,7 +21,8 @@ experimental[]
 [[ml-delete-dfanalytics-prereq]]
 ==== {api-prereq-title}
 
-If the {es} {security-features} are enabled, you must have the following built-in roles or equivalent privileges:
+If the {es} {security-features} are enabled, you must have the following 
+built-in roles or equivalent privileges:
 
 * `machine_learning_admin`
 * `kibana_user` (UI only)

docs/reference/ml/df-analytics/apis/delete-inference-trained-model.asciidoc

@@ -22,7 +22,8 @@ experimental[]
 [[ml-delete-inference-prereq]]
 ==== {api-prereq-title}
 
-If the {es} {security-features} are enabled, you must have the following built-in roles or equivalent privileges:
+If the {es} {security-features} are enabled, you must have the following 
+built-in roles or equivalent privileges:
 
 * `machine_learning_admin`
 * `kibana_user` (UI only)

docs/reference/ml/df-analytics/apis/evaluate-dfanalytics.asciidoc

@@ -22,7 +22,8 @@ experimental[]
 [[ml-evaluate-dfanalytics-prereq]]
 ==== {api-prereq-title}
 
-If the {es} {security-features} are enabled, you must have the following privileges:
+If the {es} {security-features} are enabled, you must have the following 
+privileges:
 
 * cluster: `monitor_ml`
   

docs/reference/ml/df-analytics/apis/explain-dfanalytics.asciidoc

@@ -28,7 +28,8 @@ experimental[]
 [[ml-explain-dfanalytics-prereq]]
 ==== {api-prereq-title}
 
-If the {es} {security-features} are enabled, you must have the following privileges:
+If the {es} {security-features} are enabled, you must have the following 
+privileges:
 
 * cluster: `monitor_ml`
   

docs/reference/ml/df-analytics/apis/get-dfanalytics-stats.asciidoc

@@ -28,7 +28,8 @@ experimental[]
 [[ml-get-dfanalytics-stats-prereq]]
 ==== {api-prereq-title}
 
-If the {es} {security-features} are enabled, you must have the following privileges:
+If the {es} {security-features} are enabled, you must have the following 
+privileges:
 
 * cluster: `monitor_ml`
   

docs/reference/ml/df-analytics/apis/get-dfanalytics.asciidoc

@@ -27,7 +27,8 @@ experimental[]
 [[ml-get-dfanalytics-prereq]]
 ==== {api-prereq-title}
 
-If the {es} {security-features} are enabled, you must have the following privileges:
+If the {es} {security-features} are enabled, you must have the following 
+privileges:
 
 * cluster: `monitor_ml`
   

docs/reference/ml/df-analytics/apis/get-inference-trained-model-stats.asciidoc

@@ -29,7 +29,8 @@ experimental[]
 [[ml-get-inference-stats-prereq]]
 ==== {api-prereq-title}
 
-Required privileges which should be added to a custom role:
+If the {es} {security-features} are enabled, you must have the following 
+privileges:
 
 * cluster: `monitor_ml`
   

docs/reference/ml/df-analytics/apis/get-inference-trained-model.asciidoc

@@ -29,7 +29,8 @@ experimental[]
 [[ml-get-inference-prereq]]
 ==== {api-prereq-title}
 
-Required privileges which should be added to a custom role:
+If the {es} {security-features} are enabled, you must have the following 
+privileges:
 
 * cluster: `monitor_ml`
   

docs/reference/ml/df-analytics/apis/put-dfanalytics.asciidoc

@@ -20,7 +20,8 @@ experimental[]
 [[ml-put-dfanalytics-prereq]]
 ==== {api-prereq-title}
 
-If the {es} {security-features} are enabled, you must have the following built-in roles and privileges:
+If the {es} {security-features} are enabled, you must have the following 
+built-in roles and privileges:
 
 * `machine_learning_admin`
 * `kibana_user` (UI only)
@@ -66,12 +67,11 @@ upper bound on the improvement in validation loss.
 A fixed number of rounds is used for optimization which depends on the number of 
 parameters being optimized. The optimization starts with random search, then 
 Bayesian optimization is performed that is targeting maximum expected 
-improvement. If you override any parameters,
+improvement. If you override any parameters by explicitely setting it, the 
-//TBD: What is meant by overriding them? Explicitly setting the parameter instead of letting it take the default? 
+optimization calculates the value of the remaining parameters accordingly and 
-the optimization calculates the value of the remaining parameters accordingly
+uses the value you provided for the overridden parameter. The number of rounds 
-and uses the value you provided for the overridden parameter. The number of
+are reduced respectively. The validation error is estimated in each round by 
-rounds are reduced respectively. The validation error is estimated in each round
+using 4-fold cross validation.
-by using 4-fold cross validation.
 
 [[ml-put-dfanalytics-path-params]]
 ==== {api-path-parms-title}
@@ -104,7 +104,6 @@ TIP: Advanced parameters are for fine-tuning {classanalysis}. They are set
 automatically by <<ml-hyperparam-optimization,hyperparameter optimization>> 
 to give minimum validation error. It is highly recommended to use the default 
 values unless you fully understand the function of these parameters.
-
 --
 
 `analysis`.`classification`.`dependent_variable`::::

docs/reference/ml/df-analytics/apis/start-dfanalytics.asciidoc

@@ -20,7 +20,8 @@ experimental[]
 [[ml-start-dfanalytics-prereq]]
 ==== {api-prereq-title}
 
-If the {es} {security-features} are enabled, you must have the following built-in roles and privileges:
+If the {es} {security-features} are enabled, you must have the following 
+built-in roles and privileges:
 
 * `machine_learning_admin`
 * `kibana_user` (UI only)

docs/reference/ml/df-analytics/apis/stop-dfanalytics.asciidoc

@@ -24,7 +24,8 @@ experimental[]
 [[ml-stop-dfanalytics-prereq]]
 ==== {api-prereq-title}
 
-If the {es} {security-features} are enabled, you must have the following built-in roles or equivalent privileges:
+If the {es} {security-features} are enabled, you must have the following 
+built-in roles or equivalent privileges:
 
 * `machine_learning_admin`
 * `kibana_user` (UI only)

docs/reference/rest-api/defs.asciidoc

@@ -3,7 +3,7 @@
 == Definitions
 
 The role mappings resource definition you can find below is used in APIs related 
-to security features.
+to {security-features}.
 
   * <<role-mapping-resources,Role mappings>>