diff --git a/docs/Versions.asciidoc b/docs/Versions.asciidoc
index e4f535f672f61..f738f8bd4f96e 100644
--- a/docs/Versions.asciidoc
+++ b/docs/Versions.asciidoc
@@ -1,5 +1,5 @@
 
-include::{asciidoc-dir}/../../shared/versions/stack/{source_branch}.asciidoc[]
+include::{docs-root}/shared/versions/stack/{source_branch}.asciidoc[]
 
 :lucene_version:        8.5.1
 :lucene_version_path:   8_5_1
@@ -72,4 +72,4 @@ endif::[]
 Shared attribute values are pulled from elastic/docs
 ///////
 
-include::{asciidoc-dir}/../../shared/attributes.asciidoc[]
+include::{docs-root}/shared/attributes.asciidoc[]
diff --git a/docs/reference/api-conventions.asciidoc b/docs/reference/api-conventions.asciidoc
index df0b97616b1b6..2958c370b2584 100644
--- a/docs/reference/api-conventions.asciidoc
+++ b/docs/reference/api-conventions.asciidoc
@@ -22,17 +22,17 @@ ability to "exclude" (`-`), for example: `test*,-test3`.
 
 All multi index APIs support the following url query string parameters:
 
-include::{docdir}/rest-api/common-parms.asciidoc[tag=index-ignore-unavailable]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=index-ignore-unavailable]
 
-include::{docdir}/rest-api/common-parms.asciidoc[tag=allow-no-indices]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=allow-no-indices]
 
-include::{docdir}/rest-api/common-parms.asciidoc[tag=expand-wildcards]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=expand-wildcards]
 
 The defaults settings for the above parameters depend on the API being used.
 
 Some multi index APIs also support the following url query string parameter:
 
-include::{docdir}/rest-api/common-parms.asciidoc[tag=ignore_throttled]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=ignore_throttled]
 
 NOTE: Single index APIs such as the <<docs>> and the
 <<indices-aliases,single-index `alias` APIs>> do not support multiple indices.
diff --git a/docs/reference/index.asciidoc b/docs/reference/index.asciidoc
index 18ae2e22399b4..57b372390cc6f 100644
--- a/docs/reference/index.asciidoc
+++ b/docs/reference/index.asciidoc
@@ -2,10 +2,10 @@
 = Elasticsearch Reference
 
 :include-xpack:         true
-:es-test-dir:           {docdir}/../src/test
-:plugins-examples-dir:  {docdir}/../../plugins/examples
-:xes-repo-dir:          {docdir}/../../x-pack/docs/{lang}
-:es-repo-dir:           {docdir}
+:es-test-dir:           {elasticsearch-root}/docs/src/test
+:plugins-examples-dir:  {elasticsearch-root}/plugins/examples
+:xes-repo-dir:          {elasticsearch-root}/x-pack/docs/{lang}
+:es-repo-dir:           {elasticsearch-root}/docs/reference
 
 
 include::../Versions.asciidoc[]
diff --git a/docs/reference/ml/anomaly-detection/apis/close-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/close-job.asciidoc
index b5a83edb42c83..e28027d77557c 100644
--- a/docs/reference/ml/anomaly-detection/apis/close-job.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/close-job.asciidoc
@@ -61,14 +61,14 @@ results the job might have recently produced or might produce in the future.
 
 `<job_id>`::
 (Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection-wildcard]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection-wildcard]
 
 [[ml-close-job-query-parms]]
 ==== {api-query-parms-title}
 
 `allow_no_jobs`::
 (Optional, boolean)
-include::{docdir}/ml/ml-shared.asciidoc[tag=allow-no-jobs]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=allow-no-jobs]
 
 `force`::
 (Optional, boolean) Use to close a failed job, or to forcefully close a job
diff --git a/docs/reference/ml/anomaly-detection/apis/delete-calendar-event.asciidoc b/docs/reference/ml/anomaly-detection/apis/delete-calendar-event.asciidoc
index 6cb8fddb5eab7..2403699556ba2 100644
--- a/docs/reference/ml/anomaly-detection/apis/delete-calendar-event.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/delete-calendar-event.asciidoc
@@ -32,7 +32,7 @@ events and delete the calendar, see the
 
 `<calendar_id>`::
 (Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=calendar-id]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=calendar-id]
 
 `<event_id>`::
 (Required, string) Identifier for the scheduled event. You can obtain this
diff --git a/docs/reference/ml/anomaly-detection/apis/delete-calendar-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/delete-calendar-job.asciidoc
index adf0907118175..9461f25c9c304 100644
--- a/docs/reference/ml/anomaly-detection/apis/delete-calendar-job.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/delete-calendar-job.asciidoc
@@ -25,11 +25,11 @@ Deletes {anomaly-jobs} from a calendar.
 
 `<calendar_id>`::
 (Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=calendar-id]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=calendar-id]
 
 `<job_id>`::
 (Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection-list]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection-list]
 
 [[ml-delete-calendar-job-example]]
 ==== {api-examples-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/delete-calendar.asciidoc b/docs/reference/ml/anomaly-detection/apis/delete-calendar.asciidoc
index 86e9d43591d21..943e242610a5f 100644
--- a/docs/reference/ml/anomaly-detection/apis/delete-calendar.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/delete-calendar.asciidoc
@@ -31,7 +31,7 @@ calendar.
 
 `<calendar_id>`::
 (Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=calendar-id]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=calendar-id]
 
 [[ml-delete-calendar-example]]
 ==== {api-examples-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/delete-datafeed.asciidoc b/docs/reference/ml/anomaly-detection/apis/delete-datafeed.asciidoc
index 0feda2921201e..2ec35b91b90c7 100644
--- a/docs/reference/ml/anomaly-detection/apis/delete-datafeed.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/delete-datafeed.asciidoc
@@ -29,7 +29,7 @@ can delete it.
 
 `<feed_id>`::
 (Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=datafeed-id]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=datafeed-id]
 
 [[ml-delete-datafeed-query-parms]]
 ==== {api-query-parms-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/delete-filter.asciidoc b/docs/reference/ml/anomaly-detection/apis/delete-filter.asciidoc
index e691cfea4a159..d99978231f40c 100644
--- a/docs/reference/ml/anomaly-detection/apis/delete-filter.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/delete-filter.asciidoc
@@ -32,7 +32,7 @@ update or delete the job before you can delete the filter.
 
 `<filter_id>`::
 (Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=filter-id]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=filter-id]
 
 [[ml-delete-filter-example]]
 ==== {api-examples-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/delete-forecast.asciidoc b/docs/reference/ml/anomaly-detection/apis/delete-forecast.asciidoc
index 2c9b667d0431d..ce4826713da5f 100644
--- a/docs/reference/ml/anomaly-detection/apis/delete-forecast.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/delete-forecast.asciidoc
@@ -47,7 +47,7 @@ forecasts from the job.
   
 `<job_id>`::
 (Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
 [[ml-delete-forecast-query-parms]]
 ==== {api-query-parms-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/delete-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/delete-job.asciidoc
index dce835a1a824f..872eb78bbd390 100644
--- a/docs/reference/ml/anomaly-detection/apis/delete-job.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/delete-job.asciidoc
@@ -40,7 +40,7 @@ separated list.
 
 `<job_id>`::
 (Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
 [[ml-delete-job-query-parms]]
 ==== {api-query-parms-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/delete-snapshot.asciidoc b/docs/reference/ml/anomaly-detection/apis/delete-snapshot.asciidoc
index 0894d6373d874..11f4c078744a8 100644
--- a/docs/reference/ml/anomaly-detection/apis/delete-snapshot.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/delete-snapshot.asciidoc
@@ -31,11 +31,11 @@ the `model_snapshot_id` in the results from the get jobs API.
 
 `<job_id>`::
 (Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
 `<snapshot_id>`::
 (Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=snapshot-id]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=snapshot-id]
 
 [[ml-delete-snapshot-example]]
 ==== {api-examples-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/flush-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/flush-job.asciidoc
index 2534f58f7e6ae..846e12bf76d03 100644
--- a/docs/reference/ml/anomaly-detection/apis/flush-job.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/flush-job.asciidoc
@@ -38,7 +38,7 @@ opened again before analyzing further data.
 
 `<job_id>`::
 (Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
 [[ml-flush-job-query-parms]]
 ==== {api-query-parms-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/forecast.asciidoc b/docs/reference/ml/anomaly-detection/apis/forecast.asciidoc
index ed8f42cb03e5e..83ecd47fccd5e 100644
--- a/docs/reference/ml/anomaly-detection/apis/forecast.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/forecast.asciidoc
@@ -45,7 +45,7 @@ forecast. For more information about this property, see <<ml-put-job>>.
 
 `<job_id>`::
 (Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
 [[ml-forecast-request-body]]
 ==== {api-request-body-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/get-bucket.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-bucket.asciidoc
index 268d87591f695..e0311238ce4a0 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-bucket.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-bucket.asciidoc
@@ -37,7 +37,7 @@ bucket.
 
 `<job_id>`::
 (Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
 `<timestamp>`::
 (Optional, string) The timestamp of a single bucket result. If you do not
@@ -59,7 +59,7 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=desc-results]
 
 `exclude_interim`::
 (Optional, boolean)
-include::{docdir}/ml/ml-shared.asciidoc[tag=exclude-interim-results]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=exclude-interim-results]
 
 `expand`::
 (Optional, boolean) If true, the output includes anomaly records.
@@ -115,11 +115,11 @@ initial value that was calculated at the time the bucket was processed.
 
 `is_interim`:::
 (boolean)
-include::{docdir}/ml/ml-shared.asciidoc[tag=is-interim]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=is-interim]
 
 `job_id`:::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
 `probability`:::
 (number) The probability that the bucket has this behavior, in the range 0 to 1.
@@ -139,7 +139,7 @@ this.
 
 `bucket_span`::
 (number)
-include::{docdir}/ml/ml-shared.asciidoc[tag=bucket-span-results]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=bucket-span-results]
 
 `event_count`::
 (number) The number of input data records processed in this bucket.
@@ -150,11 +150,11 @@ the initial value that was calculated at the time the bucket was processed.
 
 `is_interim`::
 (boolean)
-include::{docdir}/ml/ml-shared.asciidoc[tag=is-interim]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=is-interim]
 
 `job_id`::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
 `processing_time_ms`::
 (number) The amount of time, in milliseconds, that it took to analyze the bucket 
diff --git a/docs/reference/ml/anomaly-detection/apis/get-calendar-event.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-calendar-event.asciidoc
index 20d292a537d5e..9f0aad7406537 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-calendar-event.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-calendar-event.asciidoc
@@ -36,7 +36,7 @@ For more information, see
 
 `<calendar_id>`::
 (Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=calendar-id]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=calendar-id]
 
 [[ml-get-calendar-event-request-body]]
 ==== {api-request-body-title}
@@ -62,7 +62,7 @@ following properties:
 
 `calendar_id`::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=calendar-id]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=calendar-id]
 
 `description`::
 (string) A description of the scheduled event.
diff --git a/docs/reference/ml/anomaly-detection/apis/get-calendar.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-calendar.asciidoc
index 2893adeecf79a..74887a6bafaf7 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-calendar.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-calendar.asciidoc
@@ -36,7 +36,7 @@ For more information, see
 
 `<calendar_id>`::
 (Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=calendar-id]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=calendar-id]
 
 [[ml-get-calendar-request-body]]
 ==== {api-request-body-title}
@@ -55,7 +55,7 @@ properties:
 
 `calendar_id`::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=calendar-id]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=calendar-id]
 
 `job_ids`::
 (array) An array of {anomaly-job} identifiers. For example: `["total-requests"]`.
diff --git a/docs/reference/ml/anomaly-detection/apis/get-category.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-category.asciidoc
index 173c1c98ee57b..28de721fb9fb9 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-category.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-category.asciidoc
@@ -48,7 +48,7 @@ parameter, the API returns information about all categories in the {anomaly-job}
 
 `<job_id>`::
 (Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
 [[ml-get-category-request-body]]
 ==== {api-request-body-title}
@@ -80,7 +80,7 @@ manual tweaking.
 
 `job_id`::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
 `max_matching_length`::
 (unsigned integer) The maximum length of the fields that matched the category.
diff --git a/docs/reference/ml/anomaly-detection/apis/get-datafeed-stats.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-datafeed-stats.asciidoc
index b44645ab09a87..945a0f2b3deb7 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-datafeed-stats.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-datafeed-stats.asciidoc
@@ -46,7 +46,7 @@ IMPORTANT: This API returns a maximum of 10,000 {dfeeds}.
 
 `<feed_id>`::
 (Optional, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=datafeed-id-wildcard]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=datafeed-id-wildcard]
 +
 --
 If you do not specify one of these options, the API returns information about
@@ -58,7 +58,7 @@ all {dfeeds}.
 
 `allow_no_datafeeds`::
 (Optional, boolean)
-include::{docdir}/ml/ml-shared.asciidoc[tag=allow-no-datafeeds]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=allow-no-datafeeds]
 
 [role="child_attributes"]
 [[ml-get-datafeed-stats-results]]
@@ -69,30 +69,30 @@ informational; you cannot update their values.
 
 `assignment_explanation`::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=assignment-explanation-datafeeds]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=assignment-explanation-datafeeds]
 
 `datafeed_id`::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=datafeed-id]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=datafeed-id]
 
 `node`::
 (object)
-include::{docdir}/ml/ml-shared.asciidoc[tag=node-datafeeds]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=node-datafeeds]
 +
 --
 [%collapsible%open]
 ====
 `attributes`:::
 (object)
-include::{docdir}/ml/ml-shared.asciidoc[tag=node-attributes]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=node-attributes]
 
 `ephemeral_id`:::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=node-ephemeral-id]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=node-ephemeral-id]
 
 `id`:::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=node-id]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=node-id]
 
 `name`:::
 (string)
@@ -100,14 +100,14 @@ The node name. For example, `0-o0tOo`.
 
 `transport_address`:::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=node-transport-address]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=node-transport-address]
 
 ====
 --
 
 `state`::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=state-datafeed]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=state-datafeed]
 
 `timing_stats`::
 (object) An object that provides statistical information about timing aspect of
@@ -118,24 +118,24 @@ this {dfeed}.
 ====
 `average_search_time_per_bucket_ms`:::
 (double)
-include::{docdir}/ml/ml-shared.asciidoc[tag=search-bucket-avg]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=search-bucket-avg]
 
 `bucket_count`:::
 (long)
-include::{docdir}/ml/ml-shared.asciidoc[tag=bucket-count]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=bucket-count]
 
 `exponential_average_search_time_per_hour_ms`:::
 (double)
-include::{docdir}/ml/ml-shared.asciidoc[tag=search-exp-avg-hour]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=search-exp-avg-hour]
 
 `job_id`:::
-include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
 `search_count`:::
-include::{docdir}/ml/ml-shared.asciidoc[tag=search-count]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=search-count]
 
 `total_search_time_ms`:::
-include::{docdir}/ml/ml-shared.asciidoc[tag=search-time]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=search-time]
 ====
 --
 
diff --git a/docs/reference/ml/anomaly-detection/apis/get-datafeed.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-datafeed.asciidoc
index 8511287a23293..1623725fc31e0 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-datafeed.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-datafeed.asciidoc
@@ -43,7 +43,7 @@ IMPORTANT: This API returns a maximum of 10,000 {dfeeds}.
 
 `<feed_id>`::
 (Optional, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=datafeed-id-wildcard]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=datafeed-id-wildcard]
 +
 --
 If you do not specify one of these options, the API returns information about
@@ -55,7 +55,7 @@ all {dfeeds}.
 
 `allow_no_datafeeds`::
 (Optional, boolean)
-include::{docdir}/ml/ml-shared.asciidoc[tag=allow-no-datafeeds]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=allow-no-datafeeds]
 
 [[ml-get-datafeed-results]]
 ==== {api-response-body-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/get-filter.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-filter.asciidoc
index 5becf60bd76ee..a76ee1fded81d 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-filter.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-filter.asciidoc
@@ -33,7 +33,7 @@ You can get a single filter or all filters. For more information, see
 
 `<filter_id>`::
 (Optional, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=filter-id]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=filter-id]
 
 [[ml-get-filter-query-parms]]
 ==== {api-query-parms-title}
@@ -55,7 +55,7 @@ properties:
 
 `filter_id`::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=filter-id]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=filter-id]
   
 `items`::
 (array of strings) An array of strings which is the filter item list.
diff --git a/docs/reference/ml/anomaly-detection/apis/get-influencer.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-influencer.asciidoc
index 93d38326b2352..f7d6eecb144f7 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-influencer.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-influencer.asciidoc
@@ -35,21 +35,21 @@ the anomalies. Influencer results are available only if an
 
 `<job_id>`::
 (Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
 [[ml-get-influencer-request-body]]
 ==== {api-request-body-title}
 
 `desc`::
 (Optional, boolean)
-include::{docdir}/ml/ml-shared.asciidoc[tag=desc-results]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=desc-results]
 
 `end`::
 (Optional, string) Returns influencers with timestamps earlier than this time.
 
 `exclude_interim`::
 (Optional, boolean)
-include::{docdir}/ml/ml-shared.asciidoc[tag=exclude-interim-results]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=exclude-interim-results]
 
 `influencer_score`::
 (Optional, double) Returns influencers with anomaly scores greater than or equal
@@ -76,7 +76,7 @@ properties:
 
 `bucket_span`::
 (number)
-include::{docdir}/ml/ml-shared.asciidoc[tag=bucket-span-results]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=bucket-span-results]
 
 `influencer_score`::
 (number) A normalized score between 0-100, which is based on the probability of
@@ -98,11 +98,11 @@ calculated at the time the bucket was processed.
 
 `is_interim`::
 (boolean)
-include::{docdir}/ml/ml-shared.asciidoc[tag=is-interim]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=is-interim]
 
 `job_id`::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
 `probability`::
 (number) The probability that the influencer has this behavior, in the range 0
@@ -115,7 +115,7 @@ interpretation of this.
 
 `timestamp`::
 (date)
-include::{docdir}/ml/ml-shared.asciidoc[tag=timestamp-results]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=timestamp-results]
 
 NOTE: Additional influencer properties are added, depending on the fields being
 analyzed. For example, if it's analyzing `user_name` as an influencer, then a
diff --git a/docs/reference/ml/anomaly-detection/apis/get-job-stats.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-job-stats.asciidoc
index 46c7b18141817..161ba0637ad08 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-job-stats.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-job-stats.asciidoc
@@ -41,14 +41,14 @@ IMPORTANT: This API returns a maximum of 10,000 jobs.
 
 `<job_id>`::
 (Optional, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection-default]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection-default]
 
 [[ml-get-job-stats-query-parms]]
 ==== {api-query-parms-title}
 
 `allow_no_jobs`::
 (Optional, boolean)
-include::{docdir}/ml/ml-shared.asciidoc[tag=allow-no-jobs]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=allow-no-jobs]
 
 [role="child_attributes"]
 [[ml-get-job-stats-results]]
@@ -59,7 +59,7 @@ job:
 
 `assignment_explanation`::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=assignment-explanation-anomaly-jobs]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=assignment-explanation-anomaly-jobs]
 
 //Begin data_counts
 [[datacounts]]`data_counts`::
@@ -73,72 +73,72 @@ counts are not reset.
 ====
 `bucket_count`:::
 (long)
-include::{docdir}/ml/ml-shared.asciidoc[tag=bucket-count-anomaly-jobs]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=bucket-count-anomaly-jobs]
 
 `earliest_record_timestamp`:::
 (date)
-include::{docdir}/ml/ml-shared.asciidoc[tag=earliest-record-timestamp]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=earliest-record-timestamp]
 
 `empty_bucket_count`:::
 (long)
-include::{docdir}/ml/ml-shared.asciidoc[tag=empty-bucket-count]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=empty-bucket-count]
 
 `input_bytes`:::
 (long)
-include::{docdir}/ml/ml-shared.asciidoc[tag=input-bytes]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=input-bytes]
 
 `input_field_count`:::
 (long)
-include::{docdir}/ml/ml-shared.asciidoc[tag=input-field-count]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=input-field-count]
 
 `input_record_count`:::
 (long)
-include::{docdir}/ml/ml-shared.asciidoc[tag=input-record-count]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=input-record-count]
 
 `invalid_date_count`:::
 (long)
-include::{docdir}/ml/ml-shared.asciidoc[tag=invalid-date-count]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=invalid-date-count]
 
 `job_id`:::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
 `last_data_time`:::
 (date)
-include::{docdir}/ml/ml-shared.asciidoc[tag=last-data-time]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=last-data-time]
 
 `latest_empty_bucket_timestamp`:::
 (date)
-include::{docdir}/ml/ml-shared.asciidoc[tag=latest-empty-bucket-timestamp]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=latest-empty-bucket-timestamp]
 
 `latest_record_timestamp`:::
 (date)
-include::{docdir}/ml/ml-shared.asciidoc[tag=latest-record-timestamp]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=latest-record-timestamp]
 
 `latest_sparse_bucket_timestamp`:::
 (date)
-include::{docdir}/ml/ml-shared.asciidoc[tag=latest-sparse-record-timestamp]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=latest-sparse-record-timestamp]
 
 `missing_field_count`:::
 (long)
-include::{docdir}/ml/ml-shared.asciidoc[tag=missing-field-count]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=missing-field-count]
 +
 The value of `processed_record_count` includes this count.
 
 `out_of_order_timestamp_count`:::
 (long)
-include::{docdir}/ml/ml-shared.asciidoc[tag=out-of-order-timestamp-count]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=out-of-order-timestamp-count]
 
 `processed_field_count`:::
-include::{docdir}/ml/ml-shared.asciidoc[tag=processed-field-count]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=processed-field-count]
 
 `processed_record_count`:::
 (long)
-include::{docdir}/ml/ml-shared.asciidoc[tag=processed-record-count]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=processed-record-count]
 
 `sparse_bucket_count`:::
 (long)
-include::{docdir}/ml/ml-shared.asciidoc[tag=sparse-bucket-count]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=sparse-bucket-count]
 ====
 //End data_counts
 
@@ -184,13 +184,13 @@ omitted.
 
 `total`:::
 (long)
-include::{docdir}/ml/ml-shared.asciidoc[tag=forecast-total]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=forecast-total]
 ====
 //End forecasts_stats
 
 `job_id`::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
 //Begin model_size_stats
 [[modelsizestats]]`model_size_stats`::
@@ -202,77 +202,77 @@ model.
 ====
 `bucket_allocation_failures_count`:::
 (long)
-include::{docdir}/ml/ml-shared.asciidoc[tag=bucket-allocation-failures-count]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=bucket-allocation-failures-count]
 
 `categorized_doc_count`:::
 (long)
-include::{docdir}/ml/ml-shared.asciidoc[tag=categorized-doc-count]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=categorized-doc-count]
 
 `categorization_status`:::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=categorization-status]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=categorization-status]
 
 `dead_category_count`:::
 (long)
-include::{docdir}/ml/ml-shared.asciidoc[tag=dead-category-count]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=dead-category-count]
 
 `failed_category_count`:::
 (long)
-include::{docdir}/ml/ml-shared.asciidoc[tag=failed-category-count]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=failed-category-count]
 
 `frequent_category_count`:::
 (long)
-include::{docdir}/ml/ml-shared.asciidoc[tag=frequent-category-count]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=frequent-category-count]
 
 `job_id`:::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
 `log_time`:::
 (date) The timestamp of the `model_size_stats` according to server time.
 
 `memory_status`:::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=model-memory-status]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=model-memory-status]
 
 `model_bytes`:::
 (long)
-include::{docdir}/ml/ml-shared.asciidoc[tag=model-bytes]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=model-bytes]
 
 `model_bytes_exceeded`:::
 (long)
-include::{docdir}/ml/ml-shared.asciidoc[tag=model-bytes-exceeded]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=model-bytes-exceeded]
 
 `model_bytes_memory_limit`:::
 (long)
-include::{docdir}/ml/ml-shared.asciidoc[tag=model-memory-limit-anomaly-jobs]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=model-memory-limit-anomaly-jobs]
 
 `rare_category_count`:::
 (long)
-include::{docdir}/ml/ml-shared.asciidoc[tag=rare-category-count]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=rare-category-count]
 
 `result_type`:::
 (string) For internal use. The type of result.
 
 `total_by_field_count`:::
 (long)
-include::{docdir}/ml/ml-shared.asciidoc[tag=total-by-field-count]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=total-by-field-count]
 
 `total_category_count`:::
 (long)
-include::{docdir}/ml/ml-shared.asciidoc[tag=total-category-count]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=total-category-count]
 
 `total_over_field_count`:::
 (long)
-include::{docdir}/ml/ml-shared.asciidoc[tag=total-over-field-count]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=total-over-field-count]
 
 `total_partition_field_count`:::
 (long)
-include::{docdir}/ml/ml-shared.asciidoc[tag=total-partition-field-count]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=total-partition-field-count]
 
 `timestamp`:::
 (date)
-include::{docdir}/ml/ml-shared.asciidoc[tag=model-timestamp]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=model-timestamp]
 ====
 //End model_size_stats
 
@@ -286,15 +286,15 @@ available only for open jobs.
 ====
 `attributes`:::
 (object)
-include::{docdir}/ml/ml-shared.asciidoc[tag=node-attributes]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=node-attributes]
 
 `ephemeral_id`:::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=node-ephemeral-id]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=node-ephemeral-id]
 
 `id`:::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=node-id]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=node-id]
 
 `name`:::
 (string)
@@ -302,17 +302,17 @@ The node name.
 
 `transport_address`:::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=node-transport-address]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=node-transport-address]
 ====
 //End node
 
 `open_time`::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=open-time]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=open-time]
 
 `state`::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=state-anomaly-job]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=state-anomaly-job]
 
 //Begin timing_stats
 [[timingstats]]`timing_stats`::
@@ -327,31 +327,31 @@ this job.
 
 `bucket_count`:::
 (long)
-include::{docdir}/ml/ml-shared.asciidoc[tag=bucket-count]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=bucket-count]
 
 `exponential_average_bucket_processing_time_ms`:::
 (double)
-include::{docdir}/ml/ml-shared.asciidoc[tag=bucket-time-exponential-average]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=bucket-time-exponential-average]
 
 `exponential_average_bucket_processing_time_per_hour_ms`:::
 (double)
-include::{docdir}/ml/ml-shared.asciidoc[tag=bucket-time-exponential-average-hour]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=bucket-time-exponential-average-hour]
 
 `job_id`:::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
 `maximum_bucket_processing_time_ms`:::
 (double)
-include::{docdir}/ml/ml-shared.asciidoc[tag=bucket-time-maximum]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=bucket-time-maximum]
 
 `minimum_bucket_processing_time_ms`:::
 (double)
-include::{docdir}/ml/ml-shared.asciidoc[tag=bucket-time-minimum]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=bucket-time-minimum]
 
 `total_bucket_processing_time_ms`:::
 (double)
-include::{docdir}/ml/ml-shared.asciidoc[tag=bucket-time-total]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=bucket-time-total]
 ====
 //End timing_stats
 
diff --git a/docs/reference/ml/anomaly-detection/apis/get-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-job.asciidoc
index 608ce47fab713..54a448f6662b5 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-job.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-job.asciidoc
@@ -41,14 +41,14 @@ IMPORTANT: This API returns a maximum of 10,000 jobs.
 
 `<job_id>`::
 (Optional, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection-default]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection-default]
 
 [[ml-get-job-query-parms]]
 ==== {api-query-parms-title}
 
 `allow_no_jobs`::
 (Optional, boolean)
-include::{docdir}/ml/ml-shared.asciidoc[tag=allow-no-jobs]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=allow-no-jobs]
 
 [[ml-get-job-results]]
 ==== {api-response-body-title}
@@ -73,7 +73,7 @@ value.
 
 `model_snapshot_id`::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=snapshot-id]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=snapshot-id]
 
 [[ml-get-job-response-codes]]
 ==== {api-response-codes-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/get-overall-buckets.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-overall-buckets.asciidoc
index f4c9bcec1789f..d6ffac0bf36e9 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-overall-buckets.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-overall-buckets.asciidoc
@@ -56,14 +56,14 @@ a span equal to the jobs' largest bucket span.
 
 `<job_id>`::
 (Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection-wildcard-list]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection-wildcard-list]
 
 [[ml-get-overall-buckets-request-body]]
 ==== {api-request-body-title}
 
 `allow_no_jobs`::
 (Optional, boolean)
-include::{docdir}/ml/ml-shared.asciidoc[tag=allow-no-jobs]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=allow-no-jobs]
 
 `bucket_span`::
 (Optional, string) The span of the overall buckets. Must be greater or equal to
@@ -105,7 +105,7 @@ properties:
 
 `is_interim`::
 (boolean)
-include::{docdir}/ml/ml-shared.asciidoc[tag=is-interim]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=is-interim]
 
 `jobs`::
 (array) An array of objects that contain the `max_anomaly_score` per `job_id`.
@@ -118,7 +118,7 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=is-interim]
 
 `timestamp`::
 (date)
-include::{docdir}/ml/ml-shared.asciidoc[tag=timestamp-results]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=timestamp-results]
 
 [[ml-get-overall-buckets-example]]
 ==== {api-examples-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/get-record.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-record.asciidoc
index d392b9f4f7989..4374e2fed1edf 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-record.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-record.asciidoc
@@ -43,21 +43,21 @@ of detectors.
 
 `<job_id>`::
 (Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
 [[ml-get-record-request-body]]
 ==== {api-request-body-title}
 
 `desc`::
 (Optional, boolean)
-include::{docdir}/ml/ml-shared.asciidoc[tag=desc-results]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=desc-results]
 
 `end`::
 (Optional, string) Returns records with timestamps earlier than this time.
 
 `exclude_interim`::
 (Optional, boolean)
-include::{docdir}/ml/ml-shared.asciidoc[tag=exclude-interim-results]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=exclude-interim-results]
 
 `page`.`from`::
 (Optional, integer) Skips the specified number of records.
@@ -86,11 +86,11 @@ The API returns an array of record objects, which have the following properties:
 
 `bucket_span`::
 (number)
-include::{docdir}/ml/ml-shared.asciidoc[tag=bucket-span-results]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=bucket-span-results]
 
 `by_field_name`::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=by-field-name]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=by-field-name]
 
 `by_field_value`::
 (string) The value of the by field.
@@ -145,22 +145,22 @@ at the time the bucket was processed.
 
 `is_interim`::
 (boolean)
-include::{docdir}/ml/ml-shared.asciidoc[tag=is-interim]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=is-interim]
 
 `job_id`::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
 `over_field_name`::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=over-field-name]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=over-field-name]
 
 `over_field_value`::
 (string) The value of the over field.
 
 `partition_field_name`::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=partition-field-name]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=partition-field-name]
 
 `partition_field_value`::
 (string) The value of the partition field.
@@ -187,7 +187,7 @@ be updated by a re-normalization process as new data is analyzed.
 
 `timestamp`::
 (date)
-include::{docdir}/ml/ml-shared.asciidoc[tag=timestamp-results]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=timestamp-results]
 
 `typical`::
 (array) The typical value for the bucket, according to analytical modeling.
diff --git a/docs/reference/ml/anomaly-detection/apis/get-snapshot.asciidoc b/docs/reference/ml/anomaly-detection/apis/get-snapshot.asciidoc
index bc94cfac2ee55..0ade47018daf1 100644
--- a/docs/reference/ml/anomaly-detection/apis/get-snapshot.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/get-snapshot.asciidoc
@@ -27,11 +27,11 @@ Retrieves information about model snapshots.
 
 `<job_id>`::
 (Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
 `<snapshot_id>`::
 (Optional, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=snapshot-id]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=snapshot-id]
 +
 --
 If you do not specify this optional parameter, the API returns information about
@@ -121,7 +121,7 @@ side effect of the way categorization has no prior training.)
 
 `failed_category_count`:::
 (long)
-include::{docdir}/ml/ml-shared.asciidoc[tag=failed-category-count]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=failed-category-count]
 
 `frequent_category_count`:::
 (long) The number of categories that match more than 1% of categorized
@@ -129,7 +129,7 @@ documents.
 
 `job_id`:::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
 `log_time`:::
 (date) The timestamp that the `model_size_stats` were recorded, according to
@@ -185,7 +185,7 @@ separately for each detector and partition.
 
 `retain`::
 (boolean)
-include::{docdir}/ml/ml-shared.asciidoc[tag=retain]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=retain]
 
 `snapshot_id`::
 (string)
diff --git a/docs/reference/ml/anomaly-detection/apis/open-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/open-job.asciidoc
index 1ef61731d2f90..570e76b088aa9 100644
--- a/docs/reference/ml/anomaly-detection/apis/open-job.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/open-job.asciidoc
@@ -38,7 +38,7 @@ data is received.
 
 `<job_id>`::
 (Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
 [[ml-open-job-request-body]]
 ==== {api-request-body-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/post-calendar-event.asciidoc b/docs/reference/ml/anomaly-detection/apis/post-calendar-event.asciidoc
index 246efc4e1bd77..349d340bd04bb 100644
--- a/docs/reference/ml/anomaly-detection/apis/post-calendar-event.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/post-calendar-event.asciidoc
@@ -31,7 +31,7 @@ of which must have a start time, end time, and description.
 
 `<calendar_id>`::
 (Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=calendar-id]
+include::../../ml-shared.asciidoc[tag=calendar-id]
 
 [role="child_attributes"]
 [[ml-post-calendar-event-request-body]]
diff --git a/docs/reference/ml/anomaly-detection/apis/post-data.asciidoc b/docs/reference/ml/anomaly-detection/apis/post-data.asciidoc
index d4fa82b217f64..aca67737303e9 100644
--- a/docs/reference/ml/anomaly-detection/apis/post-data.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/post-data.asciidoc
@@ -54,7 +54,7 @@ or a comma-separated list.
 
 `<job_id>`::
 (Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
 [[ml-post-data-query-parms]]
 ==== {api-query-parms-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/preview-datafeed.asciidoc b/docs/reference/ml/anomaly-detection/apis/preview-datafeed.asciidoc
index 275a537b3707f..d867cb597dc6b 100644
--- a/docs/reference/ml/anomaly-detection/apis/preview-datafeed.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/preview-datafeed.asciidoc
@@ -44,7 +44,7 @@ supply the credentials.
 
 `<datafeed_id>`::
 (Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=datafeed-id]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=datafeed-id]
 
 [[ml-preview-datafeed-example]]
 ==== {api-examples-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/put-calendar-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/put-calendar-job.asciidoc
index ce23b07ef53a0..252a9ca7f9238 100644
--- a/docs/reference/ml/anomaly-detection/apis/put-calendar-job.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/put-calendar-job.asciidoc
@@ -25,11 +25,11 @@ Adds an {anomaly-job} to a calendar.
 
 `<calendar_id>`::
 (Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=calendar-id]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=calendar-id]
 
 `<job_id>`::
 (Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection-list]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection-list]
 
 [[ml-put-calendar-job-example]]
 ==== {api-examples-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/put-calendar.asciidoc b/docs/reference/ml/anomaly-detection/apis/put-calendar.asciidoc
index e445843feab9e..f922b1fd7d097 100644
--- a/docs/reference/ml/anomaly-detection/apis/put-calendar.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/put-calendar.asciidoc
@@ -31,7 +31,7 @@ For more information, see
 
 `<calendar_id>`::
 (Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=calendar-id]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=calendar-id]
 
 [[ml-put-calendar-request-body]]
 ==== {api-request-body-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/put-datafeed.asciidoc b/docs/reference/ml/anomaly-detection/apis/put-datafeed.asciidoc
index b4a5e87da591c..5e843953a0590 100644
--- a/docs/reference/ml/anomaly-detection/apis/put-datafeed.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/put-datafeed.asciidoc
@@ -51,7 +51,7 @@ credentials are used instead.
 
 `<feed_id>`::
 (Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=datafeed-id]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=datafeed-id]
 
 [role="child_attributes"]
 [[ml-put-datafeed-request-body]]
@@ -59,51 +59,51 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=datafeed-id]
 
 `aggregations`::
 (Optional, object)
-include::{docdir}/ml/ml-shared.asciidoc[tag=aggregations]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=aggregations]
 
 `chunking_config`::
 (Optional, object)
-include::{docdir}/ml/ml-shared.asciidoc[tag=chunking-config]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=chunking-config]
 
 `delayed_data_check_config`::
 (Optional, object)
-include::{docdir}/ml/ml-shared.asciidoc[tag=delayed-data-check-config]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=delayed-data-check-config]
 
 `frequency`::
 (Optional, <<time-units, time units>>)
-include::{docdir}/ml/ml-shared.asciidoc[tag=frequency]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=frequency]
 
 `indices`::
 (Required, array)
-include::{docdir}/ml/ml-shared.asciidoc[tag=indices]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=indices]
 
 `job_id`::
 (Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
 `max_empty_searches`::
 (Optional,integer)
-include::{docdir}/ml/ml-shared.asciidoc[tag=max-empty-searches]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=max-empty-searches]
 
 `query`::
 (Optional, object)
-include::{docdir}/ml/ml-shared.asciidoc[tag=query]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=query]
 
 `query_delay`::
 (Optional, <<time-units, time units>>)
-include::{docdir}/ml/ml-shared.asciidoc[tag=query-delay]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=query-delay]
 
 `script_fields`::
 (Optional, object)
-include::{docdir}/ml/ml-shared.asciidoc[tag=script-fields]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=script-fields]
 
 `scroll_size`::
 (Optional, unsigned integer)
-include::{docdir}/ml/ml-shared.asciidoc[tag=scroll-size]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=scroll-size]
 
 `indices_options`::
 (Optional, object)
-include::{docdir}/ml/ml-shared.asciidoc[tag=indices-options]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=indices-options]
 
 
 [[ml-put-datafeed-example]]
diff --git a/docs/reference/ml/anomaly-detection/apis/put-filter.asciidoc b/docs/reference/ml/anomaly-detection/apis/put-filter.asciidoc
index 47f3af0909193..30e916e5734cf 100644
--- a/docs/reference/ml/anomaly-detection/apis/put-filter.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/put-filter.asciidoc
@@ -32,7 +32,7 @@ the `custom_rules` property of detector configuration objects.
 
 `<filter_id>`::
 (Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=filter-id]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=filter-id]
 
 [[ml-put-filter-request-body]]
 ==== {api-request-body-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/put-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/put-job.asciidoc
index 38cdbbf60ba80..7f7cb55adfce0 100644
--- a/docs/reference/ml/anomaly-detection/apis/put-job.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/put-job.asciidoc
@@ -33,7 +33,7 @@ a job directly to the `.ml-config` index using the {es} index API. If {es}
 
 `<job_id>`::
 (Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection-define]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection-define]
 
 [role="child_attributes"]
 [[ml-put-job-request-body]]
@@ -41,31 +41,31 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection-define]
 
 `allow_lazy_open`::
 (Optional, boolean)
-include::{docdir}/ml/ml-shared.asciidoc[tag=allow-lazy-open]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=allow-lazy-open]
 
 //Begin analysis_config
 [[put-analysisconfig]]`analysis_config`::
 (Required, object)
-include::{docdir}/ml/ml-shared.asciidoc[tag=analysis-config]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=analysis-config]
 +
 .Properties of `analysis_config`
 [%collapsible%open]
 ====
 `bucket_span`:::
 (<<time-units,time units>>)
-include::{docdir}/ml/ml-shared.asciidoc[tag=bucket-span]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=bucket-span]
 
 `categorization_analyzer`:::
 (object or string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=categorization-analyzer]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=categorization-analyzer]
 
 `categorization_field_name`:::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=categorization-field-name]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=categorization-field-name]
 
 `categorization_filters`:::
 (array of strings)
-include::{docdir}/ml/ml-shared.asciidoc[tag=categorization-filters]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=categorization-filters]
 
 //Begin analysis_config.detectors
 `detectors`:::
@@ -81,12 +81,12 @@ no analysis can occur and an error is returned.
 =====
 `by_field_name`::::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=by-field-name]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=by-field-name]
 
 //Begin analysis_config.detectors.custom_rules
 [[put-customrules]]`custom_rules`::::
 (array)
-include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=custom-rules]
 +
 .Properties of `custom_rules`
 [%collapsible%open]
@@ -94,45 +94,45 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules]
 
 `actions`:::
 (array)
-include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules-actions]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=custom-rules-actions]
 
 //Begin analysis_config.detectors.custom_rules.conditions
 `conditions`:::
 (array)
-include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules-conditions]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=custom-rules-conditions]
 +
 .Properties of `conditions`
 [%collapsible%open]
 =======
 `applies_to`::::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules-conditions-applies-to]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=custom-rules-conditions-applies-to]
 
 `operator`::::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules-conditions-operator]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=custom-rules-conditions-operator]
 
 `value`::::
 (double)
-include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules-conditions-value]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=custom-rules-conditions-value]
 =======
 //End analysis_config.detectors.custom_rules.conditions
 
 //Begin analysis_config.detectors.custom_rules.scope
 `scope`:::
 (object)
-include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules-scope]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=custom-rules-scope]
 +
 .Properties of `scope`
 [%collapsible%open]
 =======
 `filter_id`::::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules-scope-filter-id]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=custom-rules-scope-filter-id]
 
 `filter_type`::::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules-scope-filter-type]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=custom-rules-scope-filter-type]
 =======
 //End analysis_config.detectors.custom_rules.scope
 ======
@@ -140,134 +140,134 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules-scope-filter-type]
 
 `detector_description`::::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=detector-description]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=detector-description]
 
 `detector_index`::::
 (integer)
-include::{docdir}/ml/ml-shared.asciidoc[tag=detector-index]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=detector-index]
 +
 If you specify a value for this property, it is ignored.
 
 `exclude_frequent`::::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=exclude-frequent]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=exclude-frequent]
 
 `field_name`::::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=detector-field-name]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=detector-field-name]
 
 `function`::::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=function]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=function]
 
 `over_field_name`::::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=over-field-name]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=over-field-name]
 
 `partition_field_name`::::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=partition-field-name]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=partition-field-name]
 
 `use_null`::::
 (boolean)
-include::{docdir}/ml/ml-shared.asciidoc[tag=use-null]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=use-null]
 =====
 //End analysis_config.detectors
 
 `influencers`:::
 (array of strings)
-include::{docdir}/ml/ml-shared.asciidoc[tag=influencers]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=influencers]
 
 `latency`:::
 (<<time-units,time units>>)
-include::{docdir}/ml/ml-shared.asciidoc[tag=latency]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=latency]
 
 `multivariate_by_fields`:::
 (boolean)
-include::{docdir}/ml/ml-shared.asciidoc[tag=multivariate-by-fields]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=multivariate-by-fields]
 
 `summary_count_field_name`:::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=summary-count-field-name]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=summary-count-field-name]
 ====
 //End analysis_config
 
 //Begin analysis_limits
 [[put-analysislimits]]`analysis_limits`::
 (Optional, object)
-include::{docdir}/ml/ml-shared.asciidoc[tag=analysis-limits]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=analysis-limits]
 +
 .Properties of `analysis_limits`
 [%collapsible%open]
 ====
 `categorization_examples_limit`:::
 (long)
-include::{docdir}/ml/ml-shared.asciidoc[tag=categorization-examples-limit]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=categorization-examples-limit]
 
 `model_memory_limit`:::
 (long or string) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=model-memory-limit]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=model-memory-limit]
 ====
 //End analysis_limits
 
 `background_persist_interval`::
 (Optional, <<time-units, time units>>)
-include::{docdir}/ml/ml-shared.asciidoc[tag=background-persist-interval]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=background-persist-interval]
 
 [[put-customsettings]]`custom_settings`::
 (Optional, object)
-include::{docdir}/ml/ml-shared.asciidoc[tag=custom-settings]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=custom-settings]
 
 //Begin data_description
 [[put-datadescription]]`data_description`::
 (Required, object)
-include::{docdir}/ml/ml-shared.asciidoc[tag=data-description]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=data-description]
 //End data_description
 
 `daily_model_snapshot_retention_after_days`::
 (Optional, long)
-include::{docdir}/ml/ml-shared.asciidoc[tag=daily-model-snapshot-retention-after-days]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=daily-model-snapshot-retention-after-days]
 
 `description`::
 (Optional, string) A description of the job.
 
 `groups`::
 (Optional, array of strings)
-include::{docdir}/ml/ml-shared.asciidoc[tag=groups]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=groups]
 
 //Begin model_plot_config
 `model_plot_config`::
 (Optional, object)
-include::{docdir}/ml/ml-shared.asciidoc[tag=model-plot-config]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=model-plot-config]
 +
 .Properties of `model_plot_config`
 [%collapsible%open]
 ====
 `enabled`:::
 (boolean)
-include::{docdir}/ml/ml-shared.asciidoc[tag=model-plot-config-enabled]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=model-plot-config-enabled]
 
 `terms`:::
 experimental[] (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=model-plot-config-terms]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=model-plot-config-terms]
 ====
 //End model_plot_config
 
 `model_snapshot_retention_days`::
 (Optional, long)
-include::{docdir}/ml/ml-shared.asciidoc[tag=model-snapshot-retention-days]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=model-snapshot-retention-days]
 
 `renormalization_window_days`::
 (Optional, long)
-include::{docdir}/ml/ml-shared.asciidoc[tag=renormalization-window-days]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=renormalization-window-days]
 
 `results_index_name`::
 (Optional, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=results-index-name]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=results-index-name]
 
 `results_retention_days`::
 (Optional, long)
-include::{docdir}/ml/ml-shared.asciidoc[tag=results-retention-days]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=results-retention-days]
 
 [[ml-put-job-example]]
 ==== {api-examples-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/revert-snapshot.asciidoc b/docs/reference/ml/anomaly-detection/apis/revert-snapshot.asciidoc
index bc682aabbdad2..6d3fef50837dd 100644
--- a/docs/reference/ml/anomaly-detection/apis/revert-snapshot.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/revert-snapshot.asciidoc
@@ -37,11 +37,11 @@ Friday or a critical system failure.
 
 `<job_id>`::
 (Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
 `<snapshot_id>`::
 (Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=snapshot-id]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=snapshot-id]
 
 [[ml-revert-snapshot-request-body]]
 ==== {api-request-body-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/start-datafeed.asciidoc b/docs/reference/ml/anomaly-detection/apis/start-datafeed.asciidoc
index 9425a26787ed7..3b787b016fa68 100644
--- a/docs/reference/ml/anomaly-detection/apis/start-datafeed.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/start-datafeed.asciidoc
@@ -77,7 +77,7 @@ you created or updated the {dfeed}, those credentials are used instead.
 
 `<feed_id>`::
 (Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=datafeed-id]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=datafeed-id]
 
 [[ml-start-datafeed-request-body]]
 ==== {api-request-body-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/stop-datafeed.asciidoc b/docs/reference/ml/anomaly-detection/apis/stop-datafeed.asciidoc
index 4366e970b238c..3a1214572a8e0 100644
--- a/docs/reference/ml/anomaly-detection/apis/stop-datafeed.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/stop-datafeed.asciidoc
@@ -41,14 +41,14 @@ comma-separated list of {dfeeds} or a wildcard expression. You can close all
 
 `<feed_id>`::
 (Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=datafeed-id-wildcard]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=datafeed-id-wildcard]
 
 [[ml-stop-datafeed-query-parms]]
 ==== {api-query-parms-title}
 
 `allow_no_datafeeds`::
 (Optional, boolean)
-include::{docdir}/ml/ml-shared.asciidoc[tag=allow-no-datafeeds]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=allow-no-datafeeds]
 
 [[ml-stop-datafeed-request-body]]
 ==== {api-request-body-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/update-datafeed.asciidoc b/docs/reference/ml/anomaly-detection/apis/update-datafeed.asciidoc
index bae9e6b8dc4f0..156ee00176f20 100644
--- a/docs/reference/ml/anomaly-detection/apis/update-datafeed.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/update-datafeed.asciidoc
@@ -42,7 +42,7 @@ credentials are used instead.
 
 `<feed_id>`::
 (Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=datafeed-id]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=datafeed-id]
 
 [role="child_attributes"]
 [[ml-update-datafeed-request-body]]
@@ -52,27 +52,27 @@ The following properties can be updated after the {dfeed} is created:
 
 `aggregations`::
 (Optional, object)
-include::{docdir}/ml/ml-shared.asciidoc[tag=aggregations]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=aggregations]
 
 `chunking_config`::
 (Optional, object)
-include::{docdir}/ml/ml-shared.asciidoc[tag=chunking-config]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=chunking-config]
   
 `delayed_data_check_config`::
 (Optional, object)
-include::{docdir}/ml/ml-shared.asciidoc[tag=delayed-data-check-config]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=delayed-data-check-config]
 
 `frequency`::
 (Optional, <<time-units, time units>>)
-include::{docdir}/ml/ml-shared.asciidoc[tag=frequency]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=frequency]
 
 `indices`::
 (Optional, array)
-include::{docdir}/ml/ml-shared.asciidoc[tag=indices]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=indices]
 
 `max_empty_searches`::
 (Optional, integer)
-include::{docdir}/ml/ml-shared.asciidoc[tag=max-empty-searches]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=max-empty-searches]
 +
 --
 The special value `-1` unsets this setting.
@@ -80,7 +80,7 @@ The special value `-1` unsets this setting.
 
 `query`::
 (Optional, object)
-include::{docdir}/ml/ml-shared.asciidoc[tag=query]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=query]
 +
 --
 WARNING: If you change the query, the analyzed data is also changed. Therefore,
@@ -94,19 +94,19 @@ the results of the other job.
 
 `query_delay`::
 (Optional, <<time-units, time units>>)
-include::{docdir}/ml/ml-shared.asciidoc[tag=query-delay]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=query-delay]
 
 `script_fields`::
 (Optional, object)
-include::{docdir}/ml/ml-shared.asciidoc[tag=script-fields]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=script-fields]
 
 `scroll_size`::
 (Optional, unsigned integer)
-include::{docdir}/ml/ml-shared.asciidoc[tag=scroll-size]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=scroll-size]
 
 `indices_options`::
 (Optional, object)
-include::{docdir}/ml/ml-shared.asciidoc[tag=indices-options]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=indices-options]
 
 [[ml-update-datafeed-example]]
 ==== {api-examples-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/update-filter.asciidoc b/docs/reference/ml/anomaly-detection/apis/update-filter.asciidoc
index 66aa9ad8dad02..f1bd8a0773b3d 100644
--- a/docs/reference/ml/anomaly-detection/apis/update-filter.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/update-filter.asciidoc
@@ -25,7 +25,7 @@ Updates the description of a filter, adds items, or removes items.
 
 `<filter_id>`::
 (Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=filter-id]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=filter-id]
 
 [[ml-update-filter-request-body]]
 ==== {api-request-body-title}
diff --git a/docs/reference/ml/anomaly-detection/apis/update-job.asciidoc b/docs/reference/ml/anomaly-detection/apis/update-job.asciidoc
index 1d28db97ca24d..2030d4e83ff9e 100644
--- a/docs/reference/ml/anomaly-detection/apis/update-job.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/update-job.asciidoc
@@ -26,7 +26,7 @@ Updates certain properties of an {anomaly-job}.
 
 `<job_id>`::
 (Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
 [role="child_attributes"]
 [[ml-update-job-request-body]]
@@ -36,7 +36,7 @@ The following properties can be updated after the job is created:
 
 `allow_lazy_open`::
 (boolean)
-include::{docdir}/ml/ml-shared.asciidoc[tag=allow-lazy-open]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=allow-lazy-open]
 +
 --
 NOTE: If the job is open when you make the update, you must stop the {dfeed},
@@ -46,14 +46,14 @@ close the job, then reopen the job and restart the {dfeed} for the changes to ta
 //Begin analysis_limits
 [[update-analysislimits]]`analysis_limits`::
 (Optional, object)
-include::{docdir}/ml/ml-shared.asciidoc[tag=analysis-limits]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=analysis-limits]
 +
 .Properties of `analysis_limits`
 [%collapsible%open]
 ====
 `model_memory_limit`:::
 (long or string) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=model-memory-limit]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=model-memory-limit]
 +
 --
 NOTE: You can update the `analysis_limits` only while the job is closed. The 
@@ -70,7 +70,7 @@ to re-run the job with an increased `model_memory_limit`.
 
 `background_persist_interval`::
 (<<time-units,time units>>)
-include::{docdir}/ml/ml-shared.asciidoc[tag=background-persist-interval]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=background-persist-interval]
 +
 --
 NOTE: If the job is open when you make the update, you must stop the {dfeed},
@@ -80,11 +80,11 @@ close the job, then reopen the job and restart the {dfeed} for the changes to ta
 
 [[update-customsettings]]`custom_settings`::
 (object)
-include::{docdir}/ml/ml-shared.asciidoc[tag=custom-settings]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=custom-settings]
 
 `daily_model_snapshot_retention_after_days`::
 (long)
-include::{docdir}/ml/ml-shared.asciidoc[tag=daily-model-snapshot-retention-after-days]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=daily-model-snapshot-retention-after-days]
 
 `description`::
 (string) A description of the job.
@@ -100,7 +100,7 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=daily-model-snapshot-retention-after
 //Begin detectors.custom_rules
 `custom_rules`:::
 (array)
-include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=custom-rules]
 +
 .Properties of `custom_rules`
 [%collapsible%open]
@@ -108,12 +108,12 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules]
 
 `actions`:::
 (array)
-include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules-actions]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=custom-rules-actions]
 
 // Begin detectors.custom_rules.conditions
 `conditions`:::
 (array)
-include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules-conditions]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=custom-rules-conditions]
 +
 .Properties of `conditions`
 [%collapsible%open]
@@ -121,33 +121,33 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules-conditions]
 
 `applies_to`::::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules-conditions-applies-to]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=custom-rules-conditions-applies-to]
 
 `operator`::::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules-conditions-operator]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=custom-rules-conditions-operator]
 
 `value`::::
 (double)
-include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules-conditions-value]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=custom-rules-conditions-value]
 ======
 //End detectors.custom_rules.conditions
 
 //Begin detectors.custom_rules.scope
 `scope`:::
 (object)
-include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules-scope]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=custom-rules-scope]
 +
 .Properties of `scope`
 [%collapsible%open]
 ======
 `filter_id`::::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules-scope-filter-id]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=custom-rules-scope-filter-id]
 
 `filter_type`::::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules-scope-filter-type]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=custom-rules-scope-filter-type]
 ======
 //End detectors.custom_rules.scope
 =====
@@ -155,11 +155,11 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=custom-rules-scope-filter-type]
 
 `description`:::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=detector-description]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=detector-description]
 
 `detector_index`:::
 (integer)
-include::{docdir}/ml/ml-shared.asciidoc[tag=detector-index]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=detector-index]
 +
 --
 If you want to update a specific detector, you must use this identifier. You
@@ -170,30 +170,30 @@ cannot, however, change the `detector_index` value for a detector.
 
 `groups`::
 (array of strings)
-include::{docdir}/ml/ml-shared.asciidoc[tag=groups]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=groups]
 
 //Begin model_plot_config
 `model_plot_config`::
 (object)
-include::{docdir}/ml/ml-shared.asciidoc[tag=model-plot-config]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=model-plot-config]
 +
 .Properties of `model_plot_config`
 [%collapsible%open]
 ====
 `enabled`:::
 (boolean)
-include::{docdir}/ml/ml-shared.asciidoc[tag=model-plot-config-enabled]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=model-plot-config-enabled]
 
 ====
 //End model_plot_config
 
 `model_snapshot_retention_days`::
 (long)
-include::{docdir}/ml/ml-shared.asciidoc[tag=model-snapshot-retention-days]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=model-snapshot-retention-days]
 
 `renormalization_window_days`::
 (long)
-include::{docdir}/ml/ml-shared.asciidoc[tag=renormalization-window-days]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=renormalization-window-days]
 +
 --
 NOTE: If the job is open when you make the update, you must stop the {dfeed},
@@ -202,7 +202,7 @@ close the job, then reopen the job and restart the {dfeed} for the changes to ta
 --
 `results_retention_days`::
 (long)
-include::{docdir}/ml/ml-shared.asciidoc[tag=results-retention-days]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=results-retention-days]
 
 
 [[ml-update-job-example]]
diff --git a/docs/reference/ml/anomaly-detection/apis/update-snapshot.asciidoc b/docs/reference/ml/anomaly-detection/apis/update-snapshot.asciidoc
index 8c8b092d3250e..805d057ca8b38 100644
--- a/docs/reference/ml/anomaly-detection/apis/update-snapshot.asciidoc
+++ b/docs/reference/ml/anomaly-detection/apis/update-snapshot.asciidoc
@@ -26,11 +26,11 @@ Updates certain properties of a snapshot.
 
 `<job_id>`::
 (Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=job-id-anomaly-detection]
 
 `<snapshot_id>`::
 (Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=snapshot-id]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=snapshot-id]
 
 [[ml-update-snapshot-request-body]]
 ==== {api-request-body-title}
@@ -42,7 +42,7 @@ The following properties can be updated after the model snapshot is created:
 
 `retain`::
 (Optional, boolean)
-include::{docdir}/ml/ml-shared.asciidoc[tag=retain]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=retain]
 
 [[ml-update-snapshot-example]]
 ==== {api-examples-title}
diff --git a/docs/reference/ml/df-analytics/apis/delete-dfanalytics.asciidoc b/docs/reference/ml/df-analytics/apis/delete-dfanalytics.asciidoc
index e9b8de84d5ee2..26f51006597a6 100644
--- a/docs/reference/ml/df-analytics/apis/delete-dfanalytics.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/delete-dfanalytics.asciidoc
@@ -34,7 +34,7 @@ For more information, see <<security-privileges>> and <<built-in-roles>>.
 
 `<data_frame_analytics_id>`::
 (Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-data-frame-analytics]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=job-id-data-frame-analytics]
 
 [[ml-delete-dfanalytics-query-params]]
 ==== {api-query-parms-title}
diff --git a/docs/reference/ml/df-analytics/apis/delete-inference-trained-model.asciidoc b/docs/reference/ml/df-analytics/apis/delete-inference-trained-model.asciidoc
index bf4e0c421de7a..2e69c44f3d891 100644
--- a/docs/reference/ml/df-analytics/apis/delete-inference-trained-model.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/delete-inference-trained-model.asciidoc
@@ -35,7 +35,7 @@ For more information, see <<security-privileges>> and <<built-in-roles>>.
 
 `<model_id>`::
 (Optional, string) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=model-id]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=model-id]
 
 
 [[ml-delete-inference-response-codes]]
diff --git a/docs/reference/ml/df-analytics/apis/explain-dfanalytics.asciidoc b/docs/reference/ml/df-analytics/apis/explain-dfanalytics.asciidoc
index cdaec54b56fc6..7d06d23d4215b 100644
--- a/docs/reference/ml/df-analytics/apis/explain-dfanalytics.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/explain-dfanalytics.asciidoc
@@ -55,7 +55,7 @@ they are not included in the explanation.
 
 `<data_frame_analytics_id>`::
 (Optional, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-data-frame-analytics]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=job-id-data-frame-analytics]
 
 [[ml-explain-dfanalytics-request-body]]
 ==== {api-request-body-title}
diff --git a/docs/reference/ml/df-analytics/apis/get-dfanalytics-stats.asciidoc b/docs/reference/ml/df-analytics/apis/get-dfanalytics-stats.asciidoc
index 0aff044b09745..fae9cc8fadd4a 100644
--- a/docs/reference/ml/df-analytics/apis/get-dfanalytics-stats.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/get-dfanalytics-stats.asciidoc
@@ -39,7 +39,7 @@ For more information, see <<security-privileges>> and <<built-in-roles>>.
 
 `<data_frame_analytics_id>`::
 (Optional, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-data-frame-analytics-default]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=job-id-data-frame-analytics-default]
 
 
 [[ml-get-dfanalytics-stats-query-params]]
@@ -47,15 +47,15 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-data-frame-analytics-default]
 
 `allow_no_match`::
 (Optional, boolean)
-include::{docdir}/ml/ml-shared.asciidoc[tag=allow-no-match]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=allow-no-match]
 
 `from`::
 (Optional, integer) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=from]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=from]
 
 `size`::
 (Optional, integer) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=size]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=size]
 
 [role="child_attributes"]
 [[ml-get-dfanalytics-stats-response-body]]
@@ -95,107 +95,107 @@ An object containing the parameters of the {classanalysis} job.
 =======
 `alpha`::::
 (double)
-include::{docdir}/ml/ml-shared.asciidoc[tag=dfas-alpha]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=dfas-alpha]
 
 `class_assignment_objective`::::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=class-assignment-objective]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=class-assignment-objective]
 
 `downsample_factor`::::
 (double)
-include::{docdir}/ml/ml-shared.asciidoc[tag=dfas-downsample-factor]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=dfas-downsample-factor]
 
 `eta`::::
 (double)
-include::{docdir}/ml/ml-shared.asciidoc[tag=eta]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=eta]
 
 `eta_growth_rate_per_tree`::::
 (double)
-include::{docdir}/ml/ml-shared.asciidoc[tag=dfas-eta-growth]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=dfas-eta-growth]
 
 `feature_bag_fraction`::::
 (double)
-include::{docdir}/ml/ml-shared.asciidoc[tag=feature-bag-fraction]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=feature-bag-fraction]
 
 `gamma`::::
 (double)
-include::{docdir}/ml/ml-shared.asciidoc[tag=gamma]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=gamma]
 
 `lambda`::::
 (double)
-include::{docdir}/ml/ml-shared.asciidoc[tag=lambda]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=lambda]
 
 `max_attempts_to_add_tree`::::
 (integer)
-include::{docdir}/ml/ml-shared.asciidoc[tag=dfas-max-attempts]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=dfas-max-attempts]
 
 `max_optimization_rounds_per_hyperparameter`::::
 (integer)
-include::{docdir}/ml/ml-shared.asciidoc[tag=dfas-max-optimization-rounds]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=dfas-max-optimization-rounds]
 
 `max_trees`::::
 (integer)
-include::{docdir}/ml/ml-shared.asciidoc[tag=max-trees]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=max-trees]
 
 `num_folds`::::
 (integer)
-include::{docdir}/ml/ml-shared.asciidoc[tag=dfas-num-folds]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=dfas-num-folds]
 
 `num_splits_per_feature`::::
 (integer)
-include::{docdir}/ml/ml-shared.asciidoc[tag=dfas-num-splits]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=dfas-num-splits]
 
 `soft_tree_depth_limit`::::
 (double)
-include::{docdir}/ml/ml-shared.asciidoc[tag=dfas-soft-limit]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=dfas-soft-limit]
 
 `soft_tree_depth_tolerance`::::
 (double)
-include::{docdir}/ml/ml-shared.asciidoc[tag=dfas-soft-tolerance]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=dfas-soft-tolerance]
 =======
 //End class_hyperparameters
 
 `iteration`::::
 (integer)
-include::{docdir}/ml/ml-shared.asciidoc[tag=dfas-iteration]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=dfas-iteration]
 
 `timestamp`::::
 (date)
-include::{docdir}/ml/ml-shared.asciidoc[tag=dfas-timestamp]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=dfas-timestamp]
 
 //Begin class_timing_stats
 `timing_stats`::::
 (object)
-include::{docdir}/ml/ml-shared.asciidoc[tag=dfas-timing-stats]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=dfas-timing-stats]
 +
 .Properties of `timing_stats`
 [%collapsible%open]
 =======
 `elapsed_time`::::
 (integer)
-include::{docdir}/ml/ml-shared.asciidoc[tag=dfas-timing-stats-elapsed]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=dfas-timing-stats-elapsed]
 
 `iteration_time`::::
 (integer)
-include::{docdir}/ml/ml-shared.asciidoc[tag=dfas-timing-stats-iteration]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=dfas-timing-stats-iteration]
 =======
 //End class_timing_stats
 
 //Begin class_validation_loss
 `validation_loss`::::
 (object)
-include::{docdir}/ml/ml-shared.asciidoc[tag=dfas-validation-loss]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=dfas-validation-loss]
 +
 .Properties of `validation_loss`
 [%collapsible%open]
 =======
 `fold_values`::::
 (array of strings)
-include::{docdir}/ml/ml-shared.asciidoc[tag=dfas-validation-loss-fold]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=dfas-validation-loss-fold]
 
 `loss_type`::::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=dfas-validation-loss-type]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=dfas-validation-loss-type]
 =======
 //End class_validation_loss
 ======
@@ -220,45 +220,45 @@ heuristics.
 =======
 `compute_feature_influence`::::
 (boolean)
-include::{docdir}/ml/ml-shared.asciidoc[tag=compute-feature-influence]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=compute-feature-influence]
 
 `feature_influence_threshold`::::
 (double)
-include::{docdir}/ml/ml-shared.asciidoc[tag=feature-influence-threshold]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=feature-influence-threshold]
 
 `method`::::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=method]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=method]
 
 `n_neighbors`::::
 (integer)
-include::{docdir}/ml/ml-shared.asciidoc[tag=n-neighbors]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=n-neighbors]
 
 `outlier_fraction`::::
 (double)
-include::{docdir}/ml/ml-shared.asciidoc[tag=outlier-fraction]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=outlier-fraction]
 
 `standardization_enabled`::::
 (boolean)
-include::{docdir}/ml/ml-shared.asciidoc[tag=standardization-enabled]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=standardization-enabled]
 =======
 //End parameters
 
 `timestamp`::::
 (date)
-include::{docdir}/ml/ml-shared.asciidoc[tag=dfas-timestamp]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=dfas-timestamp]
 
 //Begin od_timing_stats
 `timing_stats`::::
 (object)
-include::{docdir}/ml/ml-shared.asciidoc[tag=dfas-timing-stats]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=dfas-timing-stats]
 +
 .Property of `timing_stats`
 [%collapsible%open]
 =======
 `elapsed_time`::::
 (integer)
-include::{docdir}/ml/ml-shared.asciidoc[tag=dfas-timing-stats-elapsed]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=dfas-timing-stats-elapsed]
 =======
 //End od_timing_stats
 ======
@@ -282,103 +282,103 @@ An object containing the parameters of the {reganalysis}.
 =======
 `alpha`::::
 (double)
-include::{docdir}/ml/ml-shared.asciidoc[tag=dfas-alpha]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=dfas-alpha]
 
 `downsample_factor`::::
 (double)
-include::{docdir}/ml/ml-shared.asciidoc[tag=dfas-downsample-factor]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=dfas-downsample-factor]
 
 `eta`::::
 (double)
-include::{docdir}/ml/ml-shared.asciidoc[tag=eta]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=eta]
 
 `eta_growth_rate_per_tree`::::
 (double)
-include::{docdir}/ml/ml-shared.asciidoc[tag=dfas-eta-growth]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=dfas-eta-growth]
 
 `feature_bag_fraction`::::
 (double)
-include::{docdir}/ml/ml-shared.asciidoc[tag=feature-bag-fraction]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=feature-bag-fraction]
 
 `gamma`::::
 (double)
-include::{docdir}/ml/ml-shared.asciidoc[tag=gamma]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=gamma]
 
 `lambda`::::
 (double)
-include::{docdir}/ml/ml-shared.asciidoc[tag=lambda]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=lambda]
 
 `max_attempts_to_add_tree`::::
 (integer)
-include::{docdir}/ml/ml-shared.asciidoc[tag=dfas-max-attempts]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=dfas-max-attempts]
 
 `max_optimization_rounds_per_hyperparameter`::::
 (integer)
-include::{docdir}/ml/ml-shared.asciidoc[tag=dfas-max-optimization-rounds]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=dfas-max-optimization-rounds]
 
 `max_trees`::::
 (integer)
-include::{docdir}/ml/ml-shared.asciidoc[tag=max-trees]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=max-trees]
 
 `num_folds`::::
 (integer)
-include::{docdir}/ml/ml-shared.asciidoc[tag=dfas-num-folds]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=dfas-num-folds]
 
 `num_splits_per_feature`::::
 (integer)
-include::{docdir}/ml/ml-shared.asciidoc[tag=dfas-num-splits]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=dfas-num-splits]
 
 `soft_tree_depth_limit`::::
 (double)
-include::{docdir}/ml/ml-shared.asciidoc[tag=dfas-soft-limit]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=dfas-soft-limit]
 
 `soft_tree_depth_tolerance`::::
 (double)
-include::{docdir}/ml/ml-shared.asciidoc[tag=dfas-soft-tolerance]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=dfas-soft-tolerance]
 =======
 //End reg_hyperparameters
 
 `iteration`::::
 (integer)
-include::{docdir}/ml/ml-shared.asciidoc[tag=dfas-iteration]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=dfas-iteration]
 
 `timestamp`::::
 (date)
-include::{docdir}/ml/ml-shared.asciidoc[tag=dfas-timestamp]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=dfas-timestamp]
 
 //Begin reg_timing_stats
 `timing_stats`::::
 (object)
-include::{docdir}/ml/ml-shared.asciidoc[tag=dfas-timing-stats]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=dfas-timing-stats]
 +
 .Propertis of `timing_stats`
 [%collapsible%open]
 =======
 `elapsed_time`::::
 (integer)
-include::{docdir}/ml/ml-shared.asciidoc[tag=dfas-timing-stats-elapsed]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=dfas-timing-stats-elapsed]
 
 `iteration_time`::::
 (integer)
-include::{docdir}/ml/ml-shared.asciidoc[tag=dfas-timing-stats-iteration]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=dfas-timing-stats-iteration]
 =======
 //End reg_timing_stats
 
 //Begin reg_validation_loss
 `validation_loss`::::
 (object)
-include::{docdir}/ml/ml-shared.asciidoc[tag=dfas-validation-loss]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=dfas-validation-loss]
 +
 .Properties of `validation_loss`
 [%collapsible%open]
 =======
 `fold_values`::::
 (array of strings)
-include::{docdir}/ml/ml-shared.asciidoc[tag=dfas-validation-loss-fold]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=dfas-validation-loss-fold]
 
 `loss_type`::::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=dfas-validation-loss-type]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=dfas-validation-loss-type]
 =======
 //End reg_validation_loss
 ======
@@ -451,15 +451,15 @@ available only for running jobs.
 =====
 `attributes`:::
 (object)
-include::{docdir}/ml/ml-shared.asciidoc[tag=node-attributes]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=node-attributes]
 
 `ephemeral_id`:::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=node-ephemeral-id]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=node-ephemeral-id]
 
 `id`:::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=node-id]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=node-id]
 
 `name`:::
 (string)
@@ -467,7 +467,7 @@ The node name.
 
 `transport_address`:::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=node-transport-address]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=node-transport-address]
 =====
 
 `progress`:::
diff --git a/docs/reference/ml/df-analytics/apis/get-dfanalytics.asciidoc b/docs/reference/ml/df-analytics/apis/get-dfanalytics.asciidoc
index c47fed28b9239..09b7b81c58aa5 100644
--- a/docs/reference/ml/df-analytics/apis/get-dfanalytics.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/get-dfanalytics.asciidoc
@@ -46,7 +46,7 @@ by using a comma-separated list of {dfanalytics-jobs} or a wildcard expression.
 
 `<data_frame_analytics_id>`::
 (Optional, string) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-data-frame-analytics-default]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=job-id-data-frame-analytics-default]
 +
 --
 You can get information for all {dfanalytics-jobs} by using _all, by specifying 
@@ -60,15 +60,15 @@ You can get information for all {dfanalytics-jobs} by using _all, by specifying
 
 `allow_no_match`::
 (Optional, boolean) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=allow-no-match]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=allow-no-match]
 
 `from`::
 (Optional, integer) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=from]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=from]
 
 `size`::
 (Optional, integer) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=size]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=size]
 
 [role="child_attributes"]
 [[ml-get-dfanalytics-results]]
diff --git a/docs/reference/ml/df-analytics/apis/get-inference-trained-model-stats.asciidoc b/docs/reference/ml/df-analytics/apis/get-inference-trained-model-stats.asciidoc
index 8bc882084332b..d2ae624e1950c 100644
--- a/docs/reference/ml/df-analytics/apis/get-inference-trained-model-stats.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/get-inference-trained-model-stats.asciidoc
@@ -48,7 +48,7 @@ request by using a comma-separated list of model IDs or a wildcard expression.
 
 `<model_id>`::
 (Optional, string) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=model-id]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=model-id]
 
 
 [[ml-get-inference-stats-query-params]]
@@ -56,15 +56,15 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=model-id]
 
 `allow_no_match`::
 (Optional, boolean) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=allow-no-match]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=allow-no-match]
 
 `from`::
 (Optional, integer) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=from]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=from]
 
 `size`::
 (Optional, integer) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=size]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=size]
 
 
 [[ml-get-inference-stats-response-codes]]
diff --git a/docs/reference/ml/df-analytics/apis/get-inference-trained-model.asciidoc b/docs/reference/ml/df-analytics/apis/get-inference-trained-model.asciidoc
index 52e865588076a..9a11e2dcbff85 100644
--- a/docs/reference/ml/df-analytics/apis/get-inference-trained-model.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/get-inference-trained-model.asciidoc
@@ -48,7 +48,7 @@ using a comma-separated list of model IDs or a wildcard expression.
 
 `<model_id>`::
 (Optional, string) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=model-id]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=model-id]
 
 
 [[ml-get-inference-query-params]]
@@ -56,7 +56,7 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=model-id]
 
 `allow_no_match`::
 (Optional, boolean) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=allow-no-match]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=allow-no-match]
 
 `decompress_definition`::
 (Optional, boolean)
@@ -65,7 +65,7 @@ Specifies whether the included model definition should be returned as a JSON map
 
 `from`::
 (Optional, integer) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=from]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=from]
 
 `include_model_definition`::
 (Optional, boolean)
@@ -75,11 +75,11 @@ provided, otherwise a bad request is returned.
 
 `size`::
 (Optional, integer) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=size]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=size]
 
 `tags`::
 (Optional, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=tags]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=tags]
 
 [role="child_attributes"]
 [[ml-get-inference-results]]
diff --git a/docs/reference/ml/df-analytics/apis/put-dfanalytics.asciidoc b/docs/reference/ml/df-analytics/apis/put-dfanalytics.asciidoc
index 883f2c2cead59..35c76acf34c4e 100644
--- a/docs/reference/ml/df-analytics/apis/put-dfanalytics.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/put-dfanalytics.asciidoc
@@ -56,7 +56,7 @@ determines a value for each of the undefined parameters.
 
 `<data_frame_analytics_id>`::
 (Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-data-frame-analytics-define]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=job-id-data-frame-analytics-define]
 
 [role="child_attributes"]
 [[ml-put-dfanalytics-request-body]]
@@ -98,12 +98,12 @@ understand the function of these parameters.
 =====
 `class_assignment_objective`::::
 (Optional, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=class-assignment-objective]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=class-assignment-objective]
 
 `dependent_variable`::::
 (Required, string)
 +
-include::{docdir}/ml/ml-shared.asciidoc[tag=dependent-variable]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=dependent-variable]
 +
 The data type of the field must be numeric (`integer`, `short`, `long`, `byte`),
 categorical (`ip` or `keyword`), or boolean. There must be no more than 30
@@ -111,23 +111,23 @@ different values in this field.
 
 `eta`::::
 (Optional, double) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=eta]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=eta]
 
 `feature_bag_fraction`::::
 (Optional, double) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=feature-bag-fraction]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=feature-bag-fraction]
 
 `gamma`::::
 (Optional, double) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=gamma]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=gamma]
 
 `lambda`::::
 (Optional, double) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=lambda]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=lambda]
 
 `max_trees`::::
 (Optional, integer) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=max-trees]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=max-trees]
 
 `num_top_classes`::::
 (Optional, integer)
@@ -143,15 +143,15 @@ By default, it is zero and no {feat-imp} calculation occurs.
 
 `prediction_field_name`::::
 (Optional, string) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=prediction-field-name]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=prediction-field-name]
 
 `randomize_seed`::::
 (Optional, long)
-include::{docdir}/ml/ml-shared.asciidoc[tag=randomize-seed]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=randomize-seed]
 
 `training_percent`::::
 (Optional, integer)
-include::{docdir}/ml/ml-shared.asciidoc[tag=training-percent]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=training-percent]
 //End classification
 =====
 //Begin outlier_detection
@@ -165,27 +165,27 @@ The configuration information necessary to perform
 =====
 `compute_feature_influence`::::
 (Optional, boolean)
-include::{docdir}/ml/ml-shared.asciidoc[tag=compute-feature-influence]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=compute-feature-influence]
   
 `feature_influence_threshold`:::: 
 (Optional, double)
-include::{docdir}/ml/ml-shared.asciidoc[tag=feature-influence-threshold]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=feature-influence-threshold]
 
 `method`::::
 (Optional, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=method]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=method]
   
 `n_neighbors`::::
 (Optional, integer)
-include::{docdir}/ml/ml-shared.asciidoc[tag=n-neighbors]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=n-neighbors]
   
 `outlier_fraction`::::
 (Optional, double)
-include::{docdir}/ml/ml-shared.asciidoc[tag=outlier-fraction]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=outlier-fraction]
   
 `standardization_enabled`::::
 (Optional, boolean)
-include::{docdir}/ml/ml-shared.asciidoc[tag=standardization-enabled]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=standardization-enabled]
 //End outlier_detection
 =====
 //Begin regression
@@ -205,25 +205,25 @@ the function of these parameters.
 `dependent_variable`::::
 (Required, string)
 +
-include::{docdir}/ml/ml-shared.asciidoc[tag=dependent-variable]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=dependent-variable]
 +
 The data type of the field must be numeric.
 
 `eta`::::
 (Optional, double)
-include::{docdir}/ml/ml-shared.asciidoc[tag=eta]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=eta]
 
 `feature_bag_fraction`::::
 (Optional, double)
-include::{docdir}/ml/ml-shared.asciidoc[tag=feature-bag-fraction]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=feature-bag-fraction]
 
 `gamma`::::
 (Optional, double) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=gamma]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=gamma]
 
 `lambda`::::
 (Optional, double) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=lambda]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=lambda]
 
 `loss_function`::::
 (Optional, string)
@@ -239,7 +239,7 @@ A positive number that is used as a parameter to the `loss_function`.
 
 `max_trees`::::
 (Optional, integer) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=max-trees]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=max-trees]
 
 `num_top_feature_importance_values`::::
 (Optional, integer)
@@ -249,15 +249,15 @@ By default, it is zero and no {feat-imp} calculation occurs.
 
 `prediction_field_name`::::
 (Optional, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=prediction-field-name]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=prediction-field-name]
 
 `randomize_seed`::::
 (Optional, long)
-include::{docdir}/ml/ml-shared.asciidoc[tag=randomize-seed]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=randomize-seed]
 
 `training_percent`::::
 (Optional, integer)
-include::{docdir}/ml/ml-shared.asciidoc[tag=training-percent]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=training-percent]
 =====
 //End regression
 ====
@@ -319,11 +319,11 @@ analysis.
 
 `description`::
 (Optional, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=description-dfa]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=description-dfa]
 
 `dest`::
 (Required, object)
-include::{docdir}/ml/ml-shared.asciidoc[tag=dest]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=dest]
   
 `model_memory_limit`::
 (Optional, string)
diff --git a/docs/reference/ml/df-analytics/apis/put-inference.asciidoc b/docs/reference/ml/df-analytics/apis/put-inference.asciidoc
index 2562332def53a..5ca72acc1aac8 100644
--- a/docs/reference/ml/df-analytics/apis/put-inference.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/put-inference.asciidoc
@@ -47,7 +47,7 @@ is not created by {dfanalytics}.
 
 `<model_id>`::
 (Required, string) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=model-id]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=model-id]
 
 [role="child_attributes"]
 [[ml-put-inference-request-body]]
@@ -359,11 +359,11 @@ Regression configuration for inference.
 =====
 `num_top_feature_importance_values`::::
 (Optional, integer)
-include::{docdir}/ml/ml-shared.asciidoc[tag=inference-config-regression-num-top-feature-importance-values]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=inference-config-regression-num-top-feature-importance-values]
 
 `results_field`::::
 (Optional, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=inference-config-results-field]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=inference-config-results-field]
 =====
 
 `classification`:::
@@ -375,23 +375,23 @@ Classification configuration for inference.
 =====
 `num_top_classes`::::
 (Optional, integer)
-include::{docdir}/ml/ml-shared.asciidoc[tag=inference-config-classification-num-top-classes]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=inference-config-classification-num-top-classes]
 
 `num_top_feature_importance_values`::::
 (Optional, integer)
-include::{docdir}/ml/ml-shared.asciidoc[tag=inference-config-classification-num-top-feature-importance-values]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=inference-config-classification-num-top-feature-importance-values]
 
 `prediction_field_type`::::
 (Optional, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=inference-config-classification-prediction-field-type]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=inference-config-classification-prediction-field-type]
 
 `results_field`::::
 (Optional, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=inference-config-results-field]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=inference-config-results-field]
 
 `top_classes_results_field`::::
 (Optional, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=inference-config-classification-top-classes-results-field]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=inference-config-classification-top-classes-results-field]
 =====
 ====
 //End of inference_config
diff --git a/docs/reference/ml/df-analytics/apis/start-dfanalytics.asciidoc b/docs/reference/ml/df-analytics/apis/start-dfanalytics.asciidoc
index b2a73bbc7f40a..539742e375ad9 100644
--- a/docs/reference/ml/df-analytics/apis/start-dfanalytics.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/start-dfanalytics.asciidoc
@@ -58,14 +58,14 @@ when you created the job, those credentials are used.
 
 `<data_frame_analytics_id>`::
 (Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-data-frame-analytics-define]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=job-id-data-frame-analytics-define]
 
 [[ml-start-dfanalytics-query-params]]
 ==== {api-query-parms-title}
 
 `timeout`::
 (Optional, <<time-units,time units>>) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=timeout-start]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=timeout-start]
 
 [[ml-start-dfanalytics-response-body]]
 ==== {api-response-body-title}
diff --git a/docs/reference/ml/df-analytics/apis/stop-dfanalytics.asciidoc b/docs/reference/ml/df-analytics/apis/stop-dfanalytics.asciidoc
index 74020abc19aea..9be1034e2612c 100644
--- a/docs/reference/ml/df-analytics/apis/stop-dfanalytics.asciidoc
+++ b/docs/reference/ml/df-analytics/apis/stop-dfanalytics.asciidoc
@@ -48,14 +48,14 @@ stop all {dfanalytics-job} by using _all or by specifying * as the
 
 `<data_frame_analytics_id>`::
 (Required, string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-data-frame-analytics-define]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=job-id-data-frame-analytics-define]
   
 [[ml-stop-dfanalytics-query-params]]
 ==== {api-query-parms-title}  
   
 `allow_no_match`::
 (Optional, boolean) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=allow-no-match]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=allow-no-match]
 
 
 `force`::
@@ -63,7 +63,7 @@ include::{docdir}/ml/ml-shared.asciidoc[tag=allow-no-match]
   
 `timeout`::
 (Optional, <<time-units,time units>>) 
-include::{docdir}/ml/ml-shared.asciidoc[tag=timeout-stop]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=timeout-stop]
 
 
 [[ml-stop-dfanalytics-example]]
diff --git a/docs/reference/ml/ml-shared.asciidoc b/docs/reference/ml/ml-shared.asciidoc
index 7288e6ca9c0a2..2d2326f6b9ffc 100644
--- a/docs/reference/ml/ml-shared.asciidoc
+++ b/docs/reference/ml/ml-shared.asciidoc
@@ -183,15 +183,15 @@ is an object it has the following properties:
 =====
 `char_filter`::::
 (array of strings or objects)
-include::{docdir}/ml/ml-shared.asciidoc[tag=char-filter]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=char-filter]
 
 `tokenizer`::::
 (string or object)
-include::{docdir}/ml/ml-shared.asciidoc[tag=tokenizer]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=tokenizer]
 
 `filter`::::
 (array of strings or objects)
-include::{docdir}/ml/ml-shared.asciidoc[tag=filter]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=filter]
 =====
 end::categorization-analyzer[]
 
@@ -270,11 +270,11 @@ time chunks are calculated and is an advanced configuration option.
 ====
 `mode`:::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=mode]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=mode]
 
 `time_span`:::
 (<<time-units,time units>>)
-include::{docdir}/ml/ml-shared.asciidoc[tag=time-span]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=time-span]
 ====
 end::chunking-config[]
 
@@ -391,7 +391,7 @@ for {anomaly-detect} are retained.
 
 `time_format`:::
 (string)
-include::{docdir}/ml/ml-shared.asciidoc[tag=time-format]
+include::{es-repo-dir}/ml/ml-shared.asciidoc[tag=time-format]
 ====
 end::data-description[]
 
diff --git a/docs/reference/transform/apis/delete-transform.asciidoc b/docs/reference/transform/apis/delete-transform.asciidoc
index 9f304fc66c781..021a21d852507 100644
--- a/docs/reference/transform/apis/delete-transform.asciidoc
+++ b/docs/reference/transform/apis/delete-transform.asciidoc
@@ -35,7 +35,7 @@ For more information, see <<security-privileges>> and <<built-in-roles>>.
 
 `<transform_id>`::
 (Required, string)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=transform-id]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=transform-id]
 
 [[delete-transform-query-parms]]
 ==== {api-query-parms-title}
diff --git a/docs/reference/transform/apis/get-transform-stats.asciidoc b/docs/reference/transform/apis/get-transform-stats.asciidoc
index f30cf385f5786..12897fd740535 100644
--- a/docs/reference/transform/apis/get-transform-stats.asciidoc
+++ b/docs/reference/transform/apis/get-transform-stats.asciidoc
@@ -53,7 +53,7 @@ specifying `*` as the `<transform_id>`, or by omitting the
 
 `<transform_id>`::
 (Optional, string)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=transform-id-wildcard]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=transform-id-wildcard]
   
 
 [[get-transform-stats-query-parms]]
@@ -61,15 +61,15 @@ include::{docdir}/rest-api/common-parms.asciidoc[tag=transform-id-wildcard]
 
 `allow_no_match`::
 (Optional, boolean)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=allow-no-match-transforms1]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=allow-no-match-transforms1]
 
 `from`::
 (Optional, integer)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=from-transforms]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=from-transforms]
 
 `size`::
 (Optional, integer)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=size-transforms]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=size-transforms]
 
 [role="child_attributes"]
 [[get-transform-stats-response]]
@@ -88,7 +88,7 @@ informational; you cannot update their values.
 ====
 `changes_last_detected_at`:::
 (date)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=checkpointing-changes-last-detected-at]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=checkpointing-changes-last-detected-at]
 
 //Begin checkpointing.last
 `last`:::
@@ -144,7 +144,7 @@ that the {transform} is failing to keep up.
 
 `id`::
 (string)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=transform-id]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=transform-id]
 
 //Begin node
 `node`::
@@ -174,11 +174,11 @@ example, `127.0.0.1:9300`.
 
 `reason`::
 (string)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=state-transform-reason]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=state-transform-reason]
 
 `state`::
 (string)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=state-transform]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=state-transform]
 
 //Begin stats
 `stats`::
@@ -190,63 +190,63 @@ include::{docdir}/rest-api/common-parms.asciidoc[tag=state-transform]
 
 `documents_indexed`:::
 (long)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=docs-indexed]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=docs-indexed]
 
 `documents_processed`:::
 (long)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=docs-processed]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=docs-processed]
 
 `exponential_avg_checkpoint_duration_ms`:::
 (double)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=exponential-avg-checkpoint-duration-ms]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=exponential-avg-checkpoint-duration-ms]
 
 `exponential_avg_documents_indexed`:::
 (double)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=exponential-avg-documents-indexed]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=exponential-avg-documents-indexed]
 
 `exponential_avg_documents_processed`:::
 (double)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=exponential-avg-documents-processed]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=exponential-avg-documents-processed]
 
 `index_failures`:::
 (long)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=index-failures]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=index-failures]
 
 `index_time_in_ms`:::
 (long)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=index-time-ms]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=index-time-ms]
 
 `index_total`:::
 (long)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=index-total]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=index-total]
 
 `pages_processed`:::
 (long)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=pages-processed]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=pages-processed]
 
 `processing_time_in_ms`:::
 (long)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=processing-time-ms]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=processing-time-ms]
 
 `processing_total`:::
 (long)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=processing-total]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=processing-total]
 
 `search_failures`:::
 (long)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=search-failures]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=search-failures]
 
 `search_time_in_ms`:::
 (long)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=search-time-ms]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=search-time-ms]
 
 `search_total`:::
 (long)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=search-total]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=search-total]
 
 `trigger_count`:::
 (long)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=trigger-count]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=trigger-count]
 ====
 //End stats
   
diff --git a/docs/reference/transform/apis/get-transform.asciidoc b/docs/reference/transform/apis/get-transform.asciidoc
index 468bbaef20f1f..2a9ec5955469f 100644
--- a/docs/reference/transform/apis/get-transform.asciidoc
+++ b/docs/reference/transform/apis/get-transform.asciidoc
@@ -48,22 +48,22 @@ specifying `*` as the `<transform_id>`, or by omitting the `<transform_id>`.
 
 `<transform_id>`::
 (Optional, string)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=transform-id-wildcard]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=transform-id-wildcard]
   
 [[get-transform-query-parms]]
 ==== {api-query-parms-title}
 
 `allow_no_match`::
 (Optional, boolean)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=allow-no-match-transforms1]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=allow-no-match-transforms1]
 
 `from`::
 (Optional, integer)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=from-transforms]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=from-transforms]
 
 `size`::
 (Optional, integer)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=size-transforms]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=size-transforms]
 
 [[get-transform-response]]
 ==== {api-response-body-title}
diff --git a/docs/reference/transform/apis/preview-transform.asciidoc b/docs/reference/transform/apis/preview-transform.asciidoc
index bb4308e284976..2ef5daa72ae28 100644
--- a/docs/reference/transform/apis/preview-transform.asciidoc
+++ b/docs/reference/transform/apis/preview-transform.asciidoc
@@ -58,29 +58,29 @@ or an index template with your preferred mappings before you start the
 //Begin dest
 `dest`::
 (Optional, object)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=dest]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=dest]
 +
 .Properties of `dest`
 [%collapsible%open]
 ====
 `index`:::
 (Optional, string)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=dest-index]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=dest-index]
 
 `pipeline`:::
 (Optional, string)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=dest-pipeline]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=dest-pipeline]
 ====
 //End dest
 
 `frequency`::
 (Optional, <<time-units, time units>>)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=frequency]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=frequency]
 
 //Begin pivot
 `pivot`::
 (Required, object)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=pivot]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=pivot]
 +
 .Properties of `pivot`
 [%collapsible%open]
@@ -88,18 +88,18 @@ include::{docdir}/rest-api/common-parms.asciidoc[tag=pivot]
 
 `aggregations` or `aggs`:::
 (Required, object)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=pivot-aggs]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=pivot-aggs]
 
 `group_by`:::
 (Required, object)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=pivot-group-by]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=pivot-group-by]
 ====
 //End pivot
 
 //Begin source
 `source`::
 (Required, object)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=source-transforms]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=source-transforms]
 +
 .Properties of `source`
 [%collapsible%open]
@@ -107,18 +107,18 @@ include::{docdir}/rest-api/common-parms.asciidoc[tag=source-transforms]
 
 `index`:::
 (Required, string or array)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=source-index-transforms]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=source-index-transforms]
 
 `query`:::
 (Optional, object)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=source-query-transforms]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=source-query-transforms]
 ====
 //End source
 
 //Begin sync
 `sync`::
 (Optional, object)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=sync]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=sync]
 +
 .Properties of `sync`
 [%collapsible%open]
@@ -127,7 +127,7 @@ include::{docdir}/rest-api/common-parms.asciidoc[tag=sync]
 
 `time`:::
 (Optional, object)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=sync-time]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=sync-time]
 +
 .Properties of `analysis_config`
 [%collapsible%open]
@@ -135,11 +135,11 @@ include::{docdir}/rest-api/common-parms.asciidoc[tag=sync-time]
 
 `delay`::::
 (Optional, <<time-units, time units>>)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=sync-time-delay]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=sync-time-delay]
     
 `field`::::
 (Optional, string)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=sync-time-field]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=sync-time-field]
 =====
 //End sync.time
 ====
@@ -148,17 +148,17 @@ include::{docdir}/rest-api/common-parms.asciidoc[tag=sync-time-field]
 //Begin settings
 `settings`::
 (Optional, object)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=transform-settings]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=transform-settings]
 +
 .Properties of `settings`
 [%collapsible%open]
 ====
 `docs_per_second`:::
 (Optional, float)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=transform-settings-docs-per-second]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=transform-settings-docs-per-second]
 `max_page_search_size`:::
 (Optional, integer)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=transform-settings-max-page-search-size]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=transform-settings-max-page-search-size]
 ====
 //End settings
 
diff --git a/docs/reference/transform/apis/put-transform.asciidoc b/docs/reference/transform/apis/put-transform.asciidoc
index 87256f903289d..60daff036abae 100644
--- a/docs/reference/transform/apis/put-transform.asciidoc
+++ b/docs/reference/transform/apis/put-transform.asciidoc
@@ -68,7 +68,7 @@ IMPORTANT:  You must use {kib} or this API to create a {transform}.
 
 `<transform_id>`::
 (Required, string)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=transform-id]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=transform-id]
 
 [[put-transform-query-parms]]
 ==== {api-query-parms-title}
@@ -88,7 +88,7 @@ include::{docdir}/rest-api/common-parms.asciidoc[tag=transform-id]
 //Begin dest
 `dest`::
 (Required, object)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=dest]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=dest]
 +
 .Properties of `dest`
 [%collapsible%open]
@@ -96,22 +96,22 @@ include::{docdir}/rest-api/common-parms.asciidoc[tag=dest]
 
 `index`:::
 (Required, string)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=dest-index]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=dest-index]
 
 `pipeline`:::
 (Optional, string)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=dest-pipeline]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=dest-pipeline]
 ====
 //End dest
 
 `frequency`::
 (Optional, <<time-units, time units>>)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=frequency]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=frequency]
 
 //Begin pivot
 `pivot`::
 (Required, object)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=pivot]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=pivot]
 +
 .Properties of `pivot`
 [%collapsible%open]
@@ -119,11 +119,11 @@ include::{docdir}/rest-api/common-parms.asciidoc[tag=pivot]
 
 `aggregations` or `aggs`:::
 (Required, object)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=pivot-aggs]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=pivot-aggs]
 
 `group_by`:::
 (Required, object)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=pivot-group-by]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=pivot-group-by]
 
 ====
 //End pivot
@@ -131,24 +131,24 @@ include::{docdir}/rest-api/common-parms.asciidoc[tag=pivot-group-by]
 //Begin settings
 `settings`::
 (Optional, object)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=transform-settings]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=transform-settings]
 +
 .Properties of `settings`
 [%collapsible%open]
 ====
 `docs_per_second`:::
 (Optional, float)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=transform-settings-docs-per-second]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=transform-settings-docs-per-second]
 `max_page_search_size`:::
 (Optional, integer)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=transform-settings-max-page-search-size]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=transform-settings-max-page-search-size]
 ====
 //End settings
 
 //Begin source
 `source`::
 (Required, object)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=source-transforms]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=source-transforms]
 +
 .Properties of `source`
 [%collapsible%open]
@@ -156,18 +156,18 @@ include::{docdir}/rest-api/common-parms.asciidoc[tag=source-transforms]
 
 `index`:::
 (Required, string or array)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=source-index-transforms]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=source-index-transforms]
 
 `query`:::
 (Optional, object)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=source-query-transforms]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=source-query-transforms]
 ====
 //End source
 
 //Begin sync
 `sync`::
 (Optional, object)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=sync]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=sync]
 +
 .Properties of `sync`
 [%collapsible%open]
@@ -176,7 +176,7 @@ include::{docdir}/rest-api/common-parms.asciidoc[tag=sync]
 //Begin time
 `time`:::
 (Required, object)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=sync-time]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=sync-time]
 +
 .Properties of `time`
 [%collapsible%open]
@@ -184,11 +184,11 @@ include::{docdir}/rest-api/common-parms.asciidoc[tag=sync-time]
 
 `delay`::::
 (Optional, <<time-units, time units>>)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=sync-time-delay]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=sync-time-delay]
     
 `field`::::
 (Required, string)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=sync-time-field]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=sync-time-field]
 +
 --
 TIP: In general, it’s a good idea to use a field that contains the
diff --git a/docs/reference/transform/apis/start-transform.asciidoc b/docs/reference/transform/apis/start-transform.asciidoc
index 7b404203c3c62..16d47c06aba14 100644
--- a/docs/reference/transform/apis/start-transform.asciidoc
+++ b/docs/reference/transform/apis/start-transform.asciidoc
@@ -55,7 +55,7 @@ required privileges on the source and destination indices, the
 
 `<transform_id>`::
 (Required, string)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=transform-id]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=transform-id]
 
 [[start-transform-example]]
 ==== {api-examples-title}
diff --git a/docs/reference/transform/apis/stop-transform.asciidoc b/docs/reference/transform/apis/stop-transform.asciidoc
index 33f9a7b372058..9ee11a8705820 100644
--- a/docs/reference/transform/apis/stop-transform.asciidoc
+++ b/docs/reference/transform/apis/stop-transform.asciidoc
@@ -48,14 +48,14 @@ All {transforms} can be stopped by using `_all` or `*` as the
 
 `<transform_id>`::
 (Required, string)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=transform-id]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=transform-id]
 
 [[stop-transform-query-parms]]
 ==== {api-query-parms-title}
 
 `allow_no_match`::
 (Optional, boolean)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=allow-no-match-transforms2]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=allow-no-match-transforms2]
 
 `force`::
   (Optional, boolean) Set to `true` to stop a failed {transform} or to 
diff --git a/docs/reference/transform/apis/update-transform.asciidoc b/docs/reference/transform/apis/update-transform.asciidoc
index 31ff4f909c89f..5819522606361 100644
--- a/docs/reference/transform/apis/update-transform.asciidoc
+++ b/docs/reference/transform/apis/update-transform.asciidoc
@@ -62,7 +62,7 @@ give users any privileges on `.data-frame-internal*` indices.
 
 `<transform_id>`::
 (Required, string)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=transform-id]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=transform-id]
 
 [[update-transform-query-parms]]
 ==== {api-query-parms-title}
@@ -82,7 +82,7 @@ include::{docdir}/rest-api/common-parms.asciidoc[tag=transform-id]
 //Begin dest
 `dest`::
 (Optional, object)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=dest]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=dest]
 +
 .Properties of `dest`
 [%collapsible%open]
@@ -90,39 +90,39 @@ include::{docdir}/rest-api/common-parms.asciidoc[tag=dest]
 
 `index`:::
 (Required, string)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=dest-index]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=dest-index]
 
 `pipeline`:::
 (Optional, string)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=dest-pipeline]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=dest-pipeline]
 ====
 //End dest
 
 `frequency`::
 (Optional, <<time-units, time units>>)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=frequency]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=frequency]
 
 //Begin settings
 `settings`::
 (Optional, object)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=transform-settings]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=transform-settings]
 +
 .Properties of `settings`
 [%collapsible%open]
 ====
 `docs_per_second`:::
 (Optional, float)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=transform-settings-docs-per-second]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=transform-settings-docs-per-second]
 `max_page_search_size`:::
 (Optional, integer)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=transform-settings-max-page-search-size]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=transform-settings-max-page-search-size]
 ====
 //End settings
 
 //Begin source
 `source`::
 (Optional, object)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=source-transforms]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=source-transforms]
 +
 .Properties of `source`
 [%collapsible%open]
@@ -130,18 +130,18 @@ include::{docdir}/rest-api/common-parms.asciidoc[tag=source-transforms]
 
 `index`:::
 (Required, string or array)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=source-index-transforms]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=source-index-transforms]
     
 `query`:::
 (Optional, object)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=source-query-transforms]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=source-query-transforms]
 ====
 //End source
 
 //Begin sync
 `sync`::
 (Optional, object)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=sync]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=sync]
 +
 .Properties of `sync`
 [%collapsible%open]
@@ -150,7 +150,7 @@ include::{docdir}/rest-api/common-parms.asciidoc[tag=sync]
 //Begin sync.time
 `time`:::
 (Required, object)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=sync-time]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=sync-time]
 +
 .Properties of `time`
 [%collapsible%open]
@@ -158,11 +158,11 @@ include::{docdir}/rest-api/common-parms.asciidoc[tag=sync-time]
 
 `delay`::::
 (Optional, <<time-units, time units>>)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=sync-time-delay]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=sync-time-delay]
 
 `field`::::
 (Required, string)
-include::{docdir}/rest-api/common-parms.asciidoc[tag=sync-time-field]
+include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=sync-time-field]
 +
 --
 TIP: In general, it’s a good idea to use a field that contains the