Skip to content

Commit f0260c7

Browse files
Update applies_to example for same lifecycle, multiple versions (#1945)
* Update applies_to example for same lifecycle, multiple versions * Apply suggestions from code review * Add clarification about order of applies_to tags
1 parent 49c756b commit f0260c7

File tree

3 files changed

+20
-2
lines changed

3 files changed

+20
-2
lines changed

docs/contribute/cumulative-docs/example-scenarios.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -557,7 +557,7 @@ _Work in progress._
557557

558558
## Functionality is added to multiple patch versions [multiple-patch]
559559

560-
Sometimes, features and enhancements slip through into patch versions. In that case, the same functionality might be added for the first time to multiple patch versions at the same time.
560+
Sometimes, features and enhancements slip through into patch versions, and the same functionality might be added for the first time to multiple patch versions at the same time. In that case, use two `applies_to` badges so that users can see clearly the versions in which the functionality is introduced. Order the `applies_to` badges starting with the latest version, and ending with the earliest version. (Automatic ordering for multiple badges is not currently supported.)
561561

562562
For example, on the [HTTP JSON input](https://www.elastic.co/docs/reference/beats/filebeat/filebeat-input-httpjson) page, the `terminate` helper function was added to a 9.0.x and 9.1.x patch version at the same time.
563563

@@ -572,7 +572,7 @@ For example, on the [HTTP JSON input](https://www.elastic.co/docs/reference/beat
572572
```markdown
573573
* `terminate`: exits the template without falling back to the default value
574574
and without causing an error. It takes a single string argument that is
575-
logged in debug logging. {applies_to}`stack: ga 9.1.2, ga 9.0.6`
575+
logged in debug logging. {applies_to}`stack: ga 9.1.2` {applies_to}`stack: ga 9.0.6`
576576
```
577577
::::
578578
:::::
15 KB
Loading

docs/syntax/_snippets/inline-level-applies-examples.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -71,3 +71,21 @@ This example shows how to use directly a key from the second level of the `appli
7171
:::::
7272
::::::
7373

74+
::::::{dropdown} The functionality is available in the same lifecycle in multiple versions
75+
76+
:::::{tab-set}
77+
78+
::::{tab-item} Output
79+
80+
- {applies_to}`stack: ga 9.1.2` {applies_to}`stack: ga 9.0.6`
81+
82+
::::
83+
84+
::::{tab-item} Markdown
85+
```markdown
86+
- {applies_to}`stack: ga 9.1.2` {applies_to}`stack: ga 9.0.6`
87+
```
88+
::::
89+
90+
:::::
91+
::::::

0 commit comments

Comments
 (0)