diff --git a/docs/en/rest-api/ml/jobresource.asciidoc b/docs/en/rest-api/ml/jobresource.asciidoc
index dc27ac2392c..670a7e9a441 100644
--- a/docs/en/rest-api/ml/jobresource.asciidoc
+++ b/docs/en/rest-api/ml/jobresource.asciidoc
@@ -79,7 +79,8 @@ so do not set the `background_persist_interval` value too low.
 
 `model_snapshot_retention_days`::
   (long) The time in days that model snapshots are retained for the job.
-  Older snapshots are deleted. The default value is 1 day.
+  Older snapshots are deleted. The default value is `1`, which means snapshots
+  are retained for one day (twenty-four hours).
 
 `renormalization_window_days`::
   (long) Advanced configuration option.
diff --git a/docs/en/rest-api/ml/put-job.asciidoc b/docs/en/rest-api/ml/put-job.asciidoc
index ba91d585561..e8282c895cb 100644
--- a/docs/en/rest-api/ml/put-job.asciidoc
+++ b/docs/en/rest-api/ml/put-job.asciidoc
@@ -56,8 +56,8 @@ This API enables you to instantiate a job.
 
 `model_snapshot_retention_days`::
   (long) The time in days that model snapshots are retained for the job.
-  Older snapshots are deleted. The default value is 1 day. For more information
-  about model snapshots, see <<ml-snapshot-resource>>.
+  Older snapshots are deleted. The default value is `1`, which means snapshots
+  are retained for one day (twenty-four hours). 
 
 `renormalization_window_days`::
   (long) Advanced configuration option. The period over which adjustments to the
diff --git a/docs/en/rest-api/ml/snapshotresource.asciidoc b/docs/en/rest-api/ml/snapshotresource.asciidoc
index 50e3ab2cd33..fbcf038f3e0 100644
--- a/docs/en/rest-api/ml/snapshotresource.asciidoc
+++ b/docs/en/rest-api/ml/snapshotresource.asciidoc
@@ -6,9 +6,9 @@ Model snapshots are saved to disk periodically.
 By default, this is occurs approximately every 3 hours to 4 hours and is
 configurable with the `background_persist_interval` property.
 
-By default, model snapshots are retained for one day. You can change this
-behavior by updating the `model_snapshot_retention_days` for the job.
-When choosing a new value, consider the following:
+By default, model snapshots are retained for one day (twenty-four hours). You
+can change this behavior by updating the `model_snapshot_retention_days` for the
+job. When choosing a new value, consider the following:
 
 * Persistence enables resilience in the event of a system failure.
 * Persistence enables snapshots to be reverted.