Skip to content

Commit 298d38a

Browse files
committed
[DOCS] Add anchors for Asciidoctor migration (#41648)
1 parent 1d40756 commit 298d38a

File tree

53 files changed

+94
-7
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

53 files changed

+94
-7
lines changed

docs/reference/aggregations/bucket/diversified-sampler-aggregation.asciidoc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -186,6 +186,7 @@ Please note that Elasticsearch will ignore the choice of execution hint if it is
186186

187187
==== Limitations
188188

189+
[[div-sampler-breadth-first-nested-agg]]
189190
===== Cannot be nested under `breadth_first` aggregations
190191
Being a quality-based filter the diversified_sampler aggregation needs access to the relevance score produced for each document.
191192
It therefore cannot be nested under a `terms` aggregation which has the `collect_mode` switched from the default `depth_first` mode to `breadth_first` as this discards scores.
@@ -194,6 +195,7 @@ In this situation an error will be thrown.
194195
===== Limited de-dup logic.
195196
The de-duplication logic applies only at a shard level so will not apply across shards.
196197

198+
[[spec-syntax-geo-date-fields]]
197199
===== No specialized syntax for geo/date fields
198200
Currently the syntax for defining the diversifying values is defined by a choice of `field` or
199201
`script` - there is no added syntactical sugar for expressing geo or date units such as "7d" (7

docs/reference/aggregations/bucket/filters-aggregation.asciidoc

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -118,6 +118,7 @@ request. The response for this example would be:
118118
// TESTRESPONSE[s/"_shards": \.\.\./"_shards": $body._shards/]
119119
// TESTRESPONSE[s/"hits": \.\.\./"hits": $body.hits/]
120120

121+
[[other-bucket]]
121122
==== `Other` Bucket
122123

123124
The `other_bucket` parameter can be set to add a bucket to the response which will contain all documents that do

docs/reference/aggregations/bucket/sampler-aggregation.asciidoc

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -155,6 +155,7 @@ The default value is 100.
155155

156156
==== Limitations
157157

158+
[[sampler-breadth-first-nested-agg]]
158159
===== Cannot be nested under `breadth_first` aggregations
159160
Being a quality-based filter the sampler aggregation needs access to the relevance score produced for each document.
160161
It therefore cannot be nested under a `terms` aggregation which has the `collect_mode` switched from the default `depth_first` mode to `breadth_first` as this discards scores.

docs/reference/aggregations/bucket/significantterms-aggregation.asciidoc

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -438,6 +438,7 @@ Available parameters in the script are
438438
`_subset_size`:: Number of documents in the subset.
439439
`_superset_size`:: Number of documents in the superset.
440440

441+
[[sig-terms-shard-size]]
441442
===== Size & Shard Size
442443

443444
The `size` parameter can be set to define how many term buckets should be returned out of the overall terms list. By

docs/reference/aggregations/bucket/significanttext-aggregation.asciidoc

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -96,7 +96,7 @@ It only occurs 5 times in our index as a whole (see the `bg_count`) and yet 4 of
9696
were lucky enough to appear in our 100 document sample of "bird flu" results. That suggests
9797
a significant word and one which the user can potentially add to their search.
9898

99-
99+
[[filter-duplicate-text-noisy-data]]
100100
==== Dealing with noisy data using `filter_duplicate_text`
101101
Free-text fields often contain a mix of original content and mechanical copies of text (cut-and-paste biographies, email reply chains,
102102
retweets, boilerplate headers/footers, page navigation menus, sidebar news links, copyright notices, standard disclaimers, addresses).
@@ -357,7 +357,7 @@ However, the `size` and `shard size` settings covered in the next section provid
357357

358358
This aggregation supports the same scoring heuristics (JLH, mutual_information, gnd, chi_square etc) as the <<search-aggregations-bucket-significantterms-aggregation,significant terms>> aggregation
359359

360-
360+
[[sig-text-shard-size]]
361361
===== Size & Shard Size
362362

363363
The `size` parameter can be set to define how many term buckets should be returned out of the overall terms list. By

docs/reference/aggregations/pipeline/avg-bucket-aggregation.asciidoc

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,7 @@
44
A sibling pipeline aggregation which calculates the (mean) average value of a specified metric in a sibling aggregation.
55
The specified metric must be numeric and the sibling aggregation must be a multi-bucket aggregation.
66

7+
[[avg-bucket-agg-syntax]]
78
==== Syntax
89

910
An `avg_bucket` aggregation looks like this in isolation:
@@ -18,7 +19,9 @@ An `avg_bucket` aggregation looks like this in isolation:
1819
--------------------------------------------------
1920
// NOTCONSOLE
2021

22+
[[avg-bucket-params]]
2123
.`avg_bucket` Parameters
24+
[options="header"]
2225
|===
2326
|Parameter Name |Description |Required |Default Value
2427
|`buckets_path` |The path to the buckets we wish to find the average for (see <<buckets-path-syntax>> for more

docs/reference/aggregations/pipeline/bucket-script-aggregation.asciidoc

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,7 @@
44
A parent pipeline aggregation which executes a script which can perform per bucket computations on specified metrics
55
in the parent multi-bucket aggregation. The specified metric must be numeric and the script must return a numeric value.
66

7+
[[bucket-script-agg-syntax]]
78
==== Syntax
89

910
A `bucket_script` aggregation looks like this in isolation:
@@ -24,8 +25,9 @@ A `bucket_script` aggregation looks like this in isolation:
2425
<1> Here, `my_var1` is the name of the variable for this buckets path to use in the script, `the_sum` is the path to
2526
the metrics to use for that variable.
2627

27-
28+
[[bucket-script-params]]
2829
.`bucket_script` Parameters
30+
[options="header"]
2931
|===
3032
|Parameter Name |Description |Required |Default Value
3133
|`script` |The script to run for this aggregation. The script can be inline, file or indexed. (see <<modules-scripting>>

docs/reference/aggregations/pipeline/bucket-selector-aggregation.asciidoc

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,8 +29,9 @@ A `bucket_selector` aggregation looks like this in isolation:
2929
<1> Here, `my_var1` is the name of the variable for this buckets path to use in the script, `the_sum` is the path to
3030
the metrics to use for that variable.
3131

32-
32+
[[bucket-selector-params]]
3333
.`bucket_selector` Parameters
34+
[options="header"]
3435
|===
3536
|Parameter Name |Description |Required |Default Value
3637
|`script` |The script to run for this aggregation. The script can be inline, file or indexed. (see <<modules-scripting>>

docs/reference/aggregations/pipeline/bucket-sort-aggregation.asciidoc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,9 @@ A `bucket_sort` aggregation looks like this in isolation:
3333
<1> Here, `sort_field_1` is the bucket path to the variable to be used as the primary sort and its order
3434
is ascending.
3535

36+
[[bucket-sort-params]]
3637
.`bucket_sort` Parameters
38+
[options="header"]
3739
|===
3840
|Parameter Name |Description |Required |Default Value
3941
|`sort` |The list of fields to sort on. See <<search-request-sort,`sort`>> for more details. |Optional |

docs/reference/aggregations/pipeline/cumulative-sum-aggregation.asciidoc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,9 @@ A `cumulative_sum` aggregation looks like this in isolation:
1919
--------------------------------------------------
2020
// NOTCONSOLE
2121

22+
[[cumulative-sum-params]]
2223
.`cumulative_sum` Parameters
24+
[options="header"]
2325
|===
2426
|Parameter Name |Description |Required |Default Value
2527
|`buckets_path` |The path to the buckets we wish to find the cumulative sum for (see <<buckets-path-syntax>> for more

0 commit comments

Comments
 (0)