From 4ac848463eb63ff1d821f7b27bade1710efb9e4d Mon Sep 17 00:00:00 2001 From: ketkee-aryamane Date: Mon, 7 Jul 2025 09:54:07 +0200 Subject: [PATCH 1/2] rephrase warning --- .../mapping-reference/mapping-source-field.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/docs/reference/elasticsearch/mapping-reference/mapping-source-field.md b/docs/reference/elasticsearch/mapping-reference/mapping-source-field.md index aee37ea538063..2ee5807e98203 100644 --- a/docs/reference/elasticsearch/mapping-reference/mapping-source-field.md +++ b/docs/reference/elasticsearch/mapping-reference/mapping-source-field.md @@ -308,18 +308,19 @@ PUT my-index-000001 } ``` -::::{admonition} Think before disabling the _source field +::::{admonition} Think before you disable the _source field! :class: warning -Users often disable the `_source` field without thinking about the consequences, and then live to regret it. If the `_source` field isn’t available then a number of features are not supported: +Do not disable the `_source` field, unless absolutely necessary. If you disable it, the following critical features will not be supported: * The [`update`](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-update), [`update_by_query`](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-update-by-query), and [`reindex`](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-reindex) APIs. -* In the {{kib}} [Discover](docs-content://explore-analyze/discover.md) application, field data will not be displayed. +* Display of field data in the {{kib}} [Discover](docs-content://explore-analyze/discover.md) application. * On the fly [highlighting](/reference/elasticsearch/rest-apis/highlighting.md). * The ability to reindex from one Elasticsearch index to another, either to change mappings or analysis, or to upgrade an index to a new major version. * The ability to debug queries or aggregations by viewing the original document used at index time. * Potentially in the future, the ability to repair index corruption automatically. + :::: ::::{note} From ab676cb9a300622b34f6cd3d3b3d0a351e7f656c Mon Sep 17 00:00:00 2001 From: ketkee-aryamane Date: Mon, 7 Jul 2025 10:17:16 +0200 Subject: [PATCH 2/2] Update docs/reference/elasticsearch/mapping-reference/mapping-source-field.md Co-authored-by: Liam Thompson --- .../elasticsearch/mapping-reference/mapping-source-field.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/reference/elasticsearch/mapping-reference/mapping-source-field.md b/docs/reference/elasticsearch/mapping-reference/mapping-source-field.md index 2ee5807e98203..e55beb3888ae2 100644 --- a/docs/reference/elasticsearch/mapping-reference/mapping-source-field.md +++ b/docs/reference/elasticsearch/mapping-reference/mapping-source-field.md @@ -308,7 +308,7 @@ PUT my-index-000001 } ``` -::::{admonition} Think before you disable the _source field! +::::{admonition} Disabling the `_source` field :class: warning Do not disable the `_source` field, unless absolutely necessary. If you disable it, the following critical features will not be supported: