wording

Author: dnhatn

docs/reference/migration/migrate_8_0/indices.asciidoc

@@ -40,5 +40,6 @@ instead as it has the same effect as a synced flush in 7.6 and later.
 ==== Indices with soft deletes disabled
 
 Creating indices with soft deletes disabled was deprecated in 7.6 and
-is no longer supported in 8.0. Do not specify value for the setting
-`[index.soft_deletes.enabled]`.
+is no longer supported in 8.0. The setting index.soft_deletes.enabled
+can no longer be set to false. As the setting defaults to true, simply
+leave the setting unset.

server/src/main/java/org/elasticsearch/cluster/metadata/MetaDataCreateIndexService.java

@@ -437,7 +437,7 @@ static Settings aggregateIndexSettings(ClusterState currentState, CreateIndexClu
         MetaDataCreateIndexService.checkShardLimit(indexSettings, currentState);
         if (IndexSettings.INDEX_SOFT_DELETES_SETTING.get(indexSettings) == false) {
             throw new IllegalArgumentException("Creating indices with soft-deletes disabled is no longer supported. " +
-                "Please do not specify value for setting [index.soft_deletes.enabled].");
+                "Please do not specify a value for setting [index.soft_deletes.enabled].");
         }
         return indexSettings;
     }

server/src/test/java/org/elasticsearch/cluster/metadata/MetaDataCreateIndexServiceTests.java

@@ -834,7 +834,7 @@ public void testRejectWithSoftDeletesDisabled() {
                 null, Settings.EMPTY, IndexScopedSettings.DEFAULT_SCOPED_SETTINGS);
         });
         assertThat(error.getMessage(), equalTo("Creating indices with soft-deletes disabled is no longer supported. "
-            + "Please do not specify value for setting [index.soft_deletes.enabled]."));
+            + "Please do not specify a value for setting [index.soft_deletes.enabled]."));
     }
 
     private IndexTemplateMetaData addMatchingTemplate(Consumer<IndexTemplateMetaData.Builder> configurator) {