diff --git a/docs/reference/ml/apis/put-job.asciidoc b/docs/reference/ml/apis/put-job.asciidoc
index ce053484906..e28bf4f1758 100644
--- a/docs/reference/ml/apis/put-job.asciidoc
+++ b/docs/reference/ml/apis/put-job.asciidoc
@@ -65,8 +65,8 @@ Instantiates a job.
   score are applied, as new data is seen. See <<ml-job-resource>>.
 
 `results_index_name`::
-  (string) The name of the index in which to store the {ml} results. The default
-  value is `shared`, which corresponds to the index name `.ml-anomalies-shared`.
+  (string) A text string that affects the name of the {ml} results index. The 
+  default value is `shared`, which generates an index named `.ml-anomalies-shared`. 
 
 `results_retention_days`::
   (long) Advanced configuration option. The number of days for which job results