Skip to content

Commit 610d68a

Browse files
more clean up
1 parent 67c9cbd commit 610d68a

20 files changed

+102
-96
lines changed

docs/reference/aggregations/search-aggregations-bucket-adjacency-matrix-aggregation.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -99,8 +99,6 @@ The response contains buckets with document counts for each filter and combinati
9999
: (Required, [Query DSL object](/reference/query-languages/querydsl.md)) Query used to filter documents. The key is the filter name.
100100

101101
At least one filter is required. The total number of filters cannot exceed the [`indices.query.bool.max_clause_count`](/reference/elasticsearch/configuration-reference/search-settings.md#indices-query-bool-max-clause-count) setting. See [Filter limits](#adjacency-matrix-agg-filter-limits).
102-
103-
104102
::::
105103

106104

docs/reference/aggregations/search-aggregations-bucket-categorize-text-aggregation.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,8 @@ The algorithm used for categorization was completely changed in version 8.3.0. A
2626

2727
The `categorization_analyzer` field can be specified either as a string or as an object. If it is a string it must refer to a [built-in analyzer](/reference/text-analysis/analyzer-reference.md) or one added by another plugin. If it is an object it has the following properties:
2828

29-
:::::{dropdown} Properties of categorization_analyzer
29+
**Properties of `categorization_analyzer`**:
30+
3031
`char_filter`
3132
: (array of strings or objects) One or more [character filters](/reference/text-analysis/character-filter-reference.md). In addition to the built-in character filters, other plugins can provide more character filters. This property is optional. If it is not specified, no character filters are applied prior to categorization. If you are customizing some other aspect of the analyzer and you need to achieve the equivalent of `categorization_filters` (which are not permitted when some other aspect of the analyzer is customized), add them here as [pattern replace character filters](/reference/text-analysis/analysis-pattern-replace-charfilter.md).
3233

@@ -41,8 +42,6 @@ The algorithm used for categorization was completely changed in version 8.3.0. A
4142
`filter`
4243
: (array of strings or objects) One or more [token filters](/reference/text-analysis/token-filter-reference.md). In addition to the built-in token filters, other plugins can provide more token filters. This property is optional. If it is not specified, no token filters are applied prior to categorization.
4344

44-
:::::
45-
4645

4746
`categorization_filters`
4847
: (Optional, array of strings) This property expects an array of regular expressions. The expressions are used to filter out matching sequences from the categorization field values. You can use this functionality to fine tune the categorization by excluding sequences from consideration when categories are defined. For example, you can exclude SQL statements that appear in your log files. This property cannot be used at the same time as `categorization_analyzer`. If you only want to define simple regular expression filters that are applied prior to tokenization, setting this property is the easiest method. If you also want to customize the tokenizer or post-tokenization filtering, use the `categorization_analyzer` property instead and include the filters as `pattern_replace` character filters.

docs/reference/aggregations/search-aggregations-change-point-aggregation.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -46,15 +46,14 @@ A `change_point` aggregation looks like this in isolation:
4646
`bucket`
4747
: (Optional, object) Values of the bucket that indicates the discovered change point. Not returned if no change point was found. All the aggregations in the bucket are returned as well.
4848

49-
::::{dropdown} Properties of bucket
49+
**Properties of `bucket**:
50+
5051
`key`
5152
: (value) The key of the bucket matched. Could be string or numeric.
5253

5354
`doc_count`
5455
: (number) The document count of the bucket.
5556

56-
::::
57-
5857

5958
`type`
6059
: (object) The found change point type and its related values. Possible types:

docs/reference/elasticsearch-plugins/discovery-ec2.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ mapped_pages:
77

88
The EC2 discovery plugin provides a list of seed addresses to the [discovery process](docs-content://deploy-manage/distributed-architecture/discovery-cluster-formation/discovery-hosts-providers.md) by querying the [AWS API](https://github.com/aws/aws-sdk-java) for a list of EC2 instances matching certain criteria determined by the [plugin settings](/reference/elasticsearch-plugins/discovery-ec2-usage.md).
99

10-
**If you are looking for a hosted solution of {{es}} on AWS, please visit [https://www.elastic.co/cloud.**](https://www.elastic.co/cloud.**)
10+
**If you are looking for a hosted solution of {{es}} on AWS, please visit [https://www.elastic.co/cloud](https://www.elastic.co/cloud).**
1111

1212

1313
## Installation [discovery-ec2-install]

docs/reference/elasticsearch/rest-apis/api-conventions.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -324,8 +324,9 @@ Some multi-target APIs that can target indices also support the following query
324324
`ignore_throttled`
325325
: (Optional, Boolean) If `true`, concrete, expanded or aliased indices are ignored when frozen. Defaults to `true`.
326326

327-
[7.16.0]
328-
327+
:::{admonition} Deprecated in 7.16.0
328+
This parameter was deprecated in 7.16.0.
329+
:::
329330

330331
::::{note}
331332
APIs with a single target, such as the [get document API](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-get), do not support multi-target syntax.

docs/reference/query-languages/query-dsl/query-dsl-prefix-query.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -41,8 +41,12 @@ GET /_search
4141
`rewrite`
4242
: (Optional, string) Method used to rewrite the query. For valid values and more information, see the [`rewrite` parameter](/reference/query-languages/query-dsl/query-dsl-multi-term-rewrite.md).
4343

44-
`case_insensitive` [7.10.0]
45-
: (Optional, Boolean) Allows ASCII case insensitive matching of the value with the indexed field values when set to true. Default is false which means the case sensitivity of matching depends on the underlying field’s mapping.
44+
`case_insensitive`
45+
: :::{admonition} Added in 7.10.0
46+
This parameter was added in 7.10.0.
47+
:::
48+
49+
(Optional, Boolean) Allows ASCII case insensitive matching of the value with the indexed field values when set to true. Default is false which means the case sensitivity of matching depends on the underlying field’s mapping.
4650

4751

4852
## Notes [prefix-query-notes]

docs/reference/query-languages/query-dsl/query-dsl-range-query.md

Lines changed: 42 additions & 43 deletions
Original file line numberDiff line numberDiff line change
@@ -31,30 +31,30 @@ GET /_search
3131
## Top-level parameters for `range` [range-query-top-level-params]
3232

3333
`<field>`
34-
&nbsp;&nbsp;&nbsp;&nbsp; (Required, object) Field you wish to search.
34+
: (Required, object) Field you wish to search.
3535

3636

3737
## Parameters for `<field>` [range-query-field-params]
3838

3939
`gt`
40-
&nbsp;&nbsp;&nbsp;&nbsp; (Optional) Greater than.
40+
: (Optional) Greater than.
4141

4242
`gte`
43-
&nbsp;&nbsp;&nbsp;&nbsp; (Optional) Greater than or equal to.
43+
: (Optional) Greater than or equal to.
4444

4545
`lt`
46-
&nbsp;&nbsp;&nbsp;&nbsp; (Optional) Less than.
46+
: (Optional) Less than.
4747

4848
`lte`
49-
&nbsp;&nbsp;&nbsp;&nbsp; (Optional) Less than or equal to.
49+
: (Optional) Less than or equal to.
5050

5151
`format`
52-
&nbsp;&nbsp;&nbsp;&nbsp; (Optional, string) Date format used to convert `date` values in the query.
52+
: (Optional, string) Date format used to convert `date` values in the query.
5353

54-
&nbsp;&nbsp;&nbsp;&nbsp; By default, {{es}} uses the [date `format`](/reference/elasticsearch/mapping-reference/mapping-date-format.md) provided in the `<field>`'s
55-
&nbsp;&nbsp;&nbsp;&nbsp; mapping. This value overrides that mapping format.
54+
By default, {{es}} uses the [date `format`](/reference/elasticsearch/mapping-reference/mapping-date-format.md) provided in the `<field>`'s
55+
mapping. This value overrides that mapping format.
5656

57-
&nbsp;&nbsp;&nbsp;&nbsp; For valid syntax, see [`format`](/reference/elasticsearch/mapping-reference/mapping-date-format.md).
57+
For valid syntax, see [`format`](/reference/elasticsearch/mapping-reference/mapping-date-format.md).
5858

5959
::::{warning}
6060
If a format or date value is incomplete, the range query replaces any missing components with default values. See [Missing date components](#missing-date-components).
@@ -65,29 +65,28 @@ If a format or date value is incomplete, the range query replaces any missing co
6565
$$$querying-range-fields$$$
6666

6767
`relation`
68-
&nbsp;&nbsp;&nbsp;&nbsp; (Optional, string) Indicates how the range query matches values for `range`
69-
&nbsp;&nbsp;&nbsp;&nbsp; fields. Valid values are:
68+
: (Optional, string) Indicates how the range query matches values for `range`
69+
fields. Valid values are:
7070

71-
&nbsp;&nbsp;&nbsp;&nbsp; `INTERSECTS` (Default)
72-
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Matches documents with a range field value that intersects the query’s range.
71+
`INTERSECTS` (Default)
72+
: Matches documents with a range field value that intersects the query’s range.
7373

74-
&nbsp;&nbsp;&nbsp;&nbsp; `CONTAINS`
75-
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Matches documents with a range field value that entirely contains the
76-
&nbsp;&nbsp;&nbsp;&nbsp; query’s range.
74+
`CONTAINS`
75+
: Matches documents with a range field value that entirely contains the query’s range.
7776

78-
&nbsp;&nbsp;&nbsp;&nbsp; `WITHIN`
79-
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Matches documents with a range field value entirely within the query’s range.
77+
`WITHIN`
78+
: Matches documents with a range field value entirely within the query’s range.
8079

8180

8281
`time_zone`
83-
&nbsp;&nbsp;&nbsp;&nbsp; (Optional, string) [Coordinated Universal Time (UTC) offset](https://en.wikipedia.org/wiki/List_of_UTC_time_offsets) or [IANA time zone](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)
84-
&nbsp;&nbsp;&nbsp;&nbsp; used to convert `date` values in the query to UTC.
82+
: (Optional, string) [Coordinated Universal Time (UTC) offset](https://en.wikipedia.org/wiki/List_of_UTC_time_offsets) or [IANA time zone](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)
83+
used to convert `date` values in the query to UTC.
8584

86-
&nbsp;&nbsp;&nbsp;&nbsp; Valid values are ISO 8601 UTC offsets, such as `+01:00` or -`08:00`, and IANA
87-
&nbsp;&nbsp;&nbsp;&nbsp; time zone IDs, such as `America/Los_Angeles`.
85+
Valid values are ISO 8601 UTC offsets, such as `+01:00` or -`08:00`, and IANA
86+
time zone IDs, such as `America/Los_Angeles`.
8887

89-
&nbsp;&nbsp;&nbsp;&nbsp; For an example query using the `time_zone` parameter, see
90-
&nbsp;&nbsp;&nbsp;&nbsp; [Time zone in `range` queries](#range-query-time-zone).
88+
For an example query using the `time_zone` parameter, see
89+
[Time zone in `range` queries](#range-query-time-zone).
9190

9291
::::{note}
9392
The `time_zone` parameter does **not** affect the [date math](/reference/elasticsearch/rest-apis/common-options.md#date-math) value of `now`. `now` is always the current system time in UTC.
@@ -99,15 +98,15 @@ However, the `time_zone` parameter does convert dates calculated using `now` and
9998

10099

101100
`boost`
102-
&nbsp;&nbsp;&nbsp;&nbsp; (Optional, float) Floating point number used to decrease or increase the
103-
&nbsp;&nbsp;&nbsp;&nbsp; [relevance scores](/reference/query-languages/query-dsl/query-filter-context.md#relevance-scores) of a query. Defaults to `1.0`.
101+
: (Optional, float) Floating point number used to decrease or increase the
102+
[relevance scores](/reference/query-languages/query-dsl/query-filter-context.md#relevance-scores) of a query. Defaults to `1.0`.
104103

105-
&nbsp;&nbsp;&nbsp;&nbsp; You can use the `boost` parameter to adjust relevance scores for searches
106-
&nbsp;&nbsp;&nbsp;&nbsp; containing two or more queries.
104+
You can use the `boost` parameter to adjust relevance scores for searches
105+
containing two or more queries.
107106

108-
&nbsp;&nbsp;&nbsp;&nbsp; Boost values are relative to the default value of `1.0`. A boost value between `0`
109-
&nbsp;&nbsp;&nbsp;&nbsp; and `1.0` decreases the relevance score. A value greater than `1.0`
110-
&nbsp;&nbsp;&nbsp;&nbsp; increases the relevance score.
107+
Boost values are relative to the default value of `1.0`. A boost value between `0`
108+
and `1.0` decreases the relevance score. A value greater than `1.0`
109+
increases the relevance score.
111110

112111

113112

@@ -169,31 +168,31 @@ When no date format is specified and the range query is targeting a date field,
169168
{{es}} rounds [date math](/reference/elasticsearch/rest-apis/common-options.md#date-math) values in parameters as follows:
170169

171170
`gt`
172-
&nbsp;&nbsp;&nbsp;&nbsp; Rounds up to the first millisecond not covered by the rounded date.
171+
: Rounds up to the first millisecond not covered by the rounded date.
173172

174-
&nbsp;&nbsp;&nbsp;&nbsp; For example, `2014-11-18||/M` rounds up to `2014-12-01T00:00:00.000`,
175-
&nbsp;&nbsp;&nbsp;&nbsp; excluding the entire month of November.
173+
For example, `2014-11-18||/M` rounds up to `2014-12-01T00:00:00.000`,
174+
excluding the entire month of November.
176175

177176

178177
`gte`
179-
&nbsp;&nbsp;&nbsp;&nbsp; Rounds down to the first millisecond.
178+
: Rounds down to the first millisecond.
180179

181-
&nbsp;&nbsp;&nbsp;&nbsp; For example, `2014-11-18||/M` rounds down to `2014-11-01T00:00:00.000`,
182-
&nbsp;&nbsp;&nbsp;&nbsp; including the entire month.
180+
For example, `2014-11-18||/M` rounds down to `2014-11-01T00:00:00.000`,
181+
including the entire month.
183182

184183

185184
`lt`
186-
&nbsp;&nbsp;&nbsp;&nbsp; Rounds down to the last millisecond before the rounded value.
185+
: Rounds down to the last millisecond before the rounded value.
187186

188-
&nbsp;&nbsp;&nbsp;&nbsp; For example, `2014-11-18||/M` rounds down to `2014-10-31T23:59:59.999`,
189-
&nbsp;&nbsp;&nbsp;&nbsp; excluding the entire month of November.
187+
For example, `2014-11-18||/M` rounds down to `2014-10-31T23:59:59.999`,
188+
excluding the entire month of November.
190189

191190

192191
`lte`
193-
&nbsp;&nbsp;&nbsp;&nbsp; Rounds up to the latest millisecond in the rounding interval.
192+
: Rounds up to the latest millisecond in the rounding interval.
194193

195-
&nbsp;&nbsp;&nbsp;&nbsp; For example, `2014-11-18||/M` rounds up to `2014-11-30T23:59:59.999`,
196-
&nbsp;&nbsp;&nbsp;&nbsp; including the entire month.
194+
For example, `2014-11-18||/M` rounds up to `2014-11-30T23:59:59.999`,
195+
including the entire month.
197196

198197

199198

docs/reference/query-languages/query-dsl/query-dsl-regexp-query.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -55,8 +55,12 @@ GET /_search
5555
`flags`
5656
: (Optional, string) Enables optional operators for the regular expression. For valid values and more information, see [Regular expression syntax](/reference/query-languages/query-dsl/regexp-syntax.md#regexp-optional-operators).
5757

58-
`case_insensitive` [7.10.0]
59-
: (Optional, Boolean) Allows case insensitive matching of the regular expression value with the indexed field values when set to true. Default is false which means the case sensitivity of matching depends on the underlying field’s mapping.
58+
`case_insensitive`
59+
: :::{admonition} Added in 7.10.0
60+
This parameter was added in 7.10.0.
61+
:::
62+
63+
(Optional, Boolean) Allows case insensitive matching of the regular expression value with the indexed field values when set to true. Default is false which means the case sensitivity of matching depends on the underlying field’s mapping.
6064

6165
`max_determinized_states`
6266
: (Optional, integer) Maximum number of [automaton states](https://en.wikipedia.org/wiki/Deterministic_finite_automaton) required for the query. Default is `10000`.

docs/reference/query-languages/query-dsl/query-dsl-term-query.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -57,8 +57,12 @@ GET /_search
5757
Boost values are relative to the default value of `1.0`. A boost value between `0` and `1.0` decreases the relevance score. A value greater than `1.0` increases the relevance score.
5858

5959

60-
`case_insensitive` [7.10.0]
61-
: (Optional, Boolean) Allows ASCII case insensitive matching of the value with the indexed field values when set to true. Default is false which means the case sensitivity of matching depends on the underlying field’s mapping.
60+
`case_insensitive`
61+
: :::{admonition} Added in 7.10.0
62+
This parameter was added in 7.10.0.
63+
:::
64+
65+
(Optional, Boolean) Allows ASCII case insensitive matching of the value with the indexed field values when set to true. Default is false which means the case sensitivity of matching depends on the underlying field’s mapping.
6266

6367

6468
## Notes [term-query-notes]

docs/reference/query-languages/query-dsl/query-dsl-wildcard-query.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -47,8 +47,12 @@ GET /_search
4747
Boost values are relative to the default value of `1.0`. A boost value between `0` and `1.0` decreases the relevance score. A value greater than `1.0` increases the relevance score.
4848

4949

50-
`case_insensitive` [7.10.0]
51-
: (Optional, Boolean) Allows case insensitive matching of the pattern with the indexed field values when set to true. Default is false which means the case sensitivity of matching depends on the underlying field’s mapping.
50+
`case_insensitive`
51+
: :::{admonition} Added in 7.10.0
52+
This parameter was added in 7.10.0.
53+
:::
54+
55+
(Optional, Boolean) Allows case insensitive matching of the pattern with the indexed field values when set to true. Default is false which means the case sensitivity of matching depends on the underlying field’s mapping.
5256

5357
`rewrite`
5458
: (Optional, string) Method used to rewrite the query. For valid values and more information, see the [`rewrite` parameter](/reference/query-languages/query-dsl/query-dsl-multi-term-rewrite.md).

0 commit comments

Comments
 (0)