[DOCS] Fix source-related search API params (#57691) (#57889)

Cleans up the reference documentation for the following
search API parameters:

* `_source` query parameter
* `_source_excludes` query parameter
* `_source_includes` query parameter
* `_source` request body parameter
* `hits._source` response property

docs/reference/rest-api/common-parms.asciidoc

@@ -868,14 +868,26 @@ end::source[]
 
 tag::source_excludes[]
 `_source_excludes`::
-(Optional, string) A list of fields to exclude from the returned `_source`
-field.
+(Optional, string)
+A comma-separated list of <<mapping-source-field,source fields>> to exclude from
+the response.
++
+You can also use this parameter to exclude fields from the subset specified in
+`_source_includes` query parameter.
++
+If the `_source` parameter is `false`, this parameter is ignored.
 end::source_excludes[]
 
 tag::source_includes[]
 `_source_includes`::
-(Optional, string) A list of fields to extract and return from the `_source`
-field.
+(Optional, string)
+A comma-separated list of <<mapping-source-field,source fields>> to
+include in the response.
++
+If this parameter is specified, only these source fields are returned. You can
+exclude fields from this subset using the `_source_excludes` query parameter.
++
+If the `_source` parameter is `false`, this parameter is ignored.
 end::source_includes[]
 
 tag::source-transforms[]

docs/reference/search/search.asciidoc

@@ -35,6 +35,7 @@ query string parameter>> or <<search-request-body,request body>>.
 
 include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=index]
 
+[role="child_attributes"]
 [[search-search-api-query-params]]
 ==== {api-query-parms-title}
 
@@ -137,7 +138,6 @@ IMPORTANT: The `q` parameter overrides the <<request-body-search-query,`query`>>
 parameter in the request body. If both parameters are specified, documents
 matching the `query` request body parameter are not returned.
 
-
 `request_cache`::
 (Optional, boolean) If `true`, the caching of search results is enabled for
 requests where `size` is `0`. See <<shard-request-cache>>. Defaults to index
@@ -192,9 +192,27 @@ value cannot be `0`.
 (Optional, string) A comma-separated list of <field>:<direction> pairs.
 
 `_source`::
-(Optional, boolean)
-If `true`, the response includes the `_source` of matching documents under
-`hits`. Defaults to `true`.
+(Optional)
+Indicates which <<mapping-source-field,source fields>> are returned for matching
+documents. These fields are returned in the `hits._source` property of
+the search response. Defaults to `true`.
++
+.Valid values for `_source`
+[%collapsible%open]
+====
+`true`::
+(boolean)
+The entire document source is returned.
+
+`false`::
+(boolean)
+The document source is not returned.
+
+`<string>`::
+(string)
+Comma-separated list of source fields to return.
+Wildcard (`*`) patterns are supported.
+====
 
 include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=source_excludes]
 
@@ -208,6 +226,10 @@ purposes.
 (Optional, string) A comma-separated list of stored fields to return as part
 of a hit. If no fields are specified, no stored fields are included in the
 response.
++
+If this field is specified, the `_source` parameter defaults to `false`. You can
+pass `_source: true` to return both source fields and
+stored fields in the search response.
 
 `suggest_field`::
 (Optional, string) Specifies which field to use for suggestions.
@@ -244,6 +266,7 @@ by their respective types in the response. Defaults to `true`.
 (Optional, boolean)
 If `true`, returns document version as part of a hit. Defaults to `false`.
 
+[role="child_attributes"]
 [[search-search-api-request-body]]
 ==== {api-request-body-title}
 
@@ -302,6 +325,51 @@ If the <<search-api-scroll-query-param,`scroll` parameter>> is specified, this
 value cannot be `0`.
 --
 
+`_source`::
+(Optional)
+Indicates which <<mapping-source-field,source fields>> are returned for matching
+documents. These fields are returned in the `hits._source` property of
+the search response. Defaults to `true`.
++
+.Valid values for `_source`
+[%collapsible%open]
+====
+`true`::
+(boolean)
+The entire document source is returned.
+
+`false`::
+(boolean)
+The document source is not returned.
+
+`<wildcard_pattern>`::
+(string or array of strings)
+Wildcard (`*`) pattern or array of patterns containing source fields to return.
+
+`<object>`::
+(object)
+Object containing a list of source fields to include or exclude.
++
+.Properties for `<object>`
+[%collapsible%open]
+=====
+`excludes`::
+(string or array of strings)
+Wildcard (`*`) pattern or array of patterns containing source fields to exclude
+from the response.
++
+You can also use this property to exclude fields from the subset specified in
+`includes` property.
+
+`includes`::
+(string or array of strings)
+Wildcard (`*`) pattern or array of patterns containing source fields to return.
++
+If this property is specified, only these source fields are returned. You can
+exclude fields from this subset using the `excludes` property.
+=====
+====
+
 include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=terminate_after]
 +
 Defaults to `0`, which does not terminate query execution early.
@@ -462,6 +530,9 @@ returned document.
 `_source`::
 (object)
 Original JSON body passed for the document at index time.
++
+You can use the `_source` parameter to exclude this property from the response
+or specify which source fields to return.
 =====
 ====