diff --git a/contribute-docs/_snippets/applies_to-lifecycle.md b/contribute-docs/_snippets/applies_to-lifecycle.md index 439613d3cc..1212033e28 100644 --- a/contribute-docs/_snippets/applies_to-lifecycle.md +++ b/contribute-docs/_snippets/applies_to-lifecycle.md @@ -1,8 +1,8 @@ `applies_to` accepts the following lifecycle states: +* `experimental` * `preview` -* `beta` * `ga` * `deprecated` * `removed` -* `unavailable` \ No newline at end of file +* `unavailable` diff --git a/contribute-docs/_snippets/tag-processing.md b/contribute-docs/_snippets/tag-processing.md index 6a225afd0f..76be07d19b 100644 --- a/contribute-docs/_snippets/tag-processing.md +++ b/contribute-docs/_snippets/tag-processing.md @@ -4,18 +4,18 @@ Specifically for versioned products, badges will display differently when the `a The following table shows how badges for versioned products are displayed based on the release status for each lifecycle value. Hover over the example badges for the tooltip text. -| Lifecycle | Release status | Badge text examples | -|-------------|----------------|---------------------------------------| -| preview | prerelease | {applies_to}`stack: preview 99.99` | -| | post-release | {applies_to}`stack: preview 9.1` | -| beta | prerelease | {applies_to}`stack: beta 99.99` | -| | post-release | {applies_to}`stack: beta 9.1` | -| ga | prerelease | {applies_to}`stack: ga 99.99` | -| | post-release | {applies_to}`stack: ga 9.1` | -| deprecated | prerelease | {applies_to}`stack: deprecated 99.99` | -| | post-release | {applies_to}`stack: deprecated 9.1` | -| removed | prerelease | {applies_to}`stack: removed 99.99` | -| | post-release | {applies_to}`stack: removed 9.1` | +| Lifecycle | Release status | Badge text examples | +|--------------|----------------|----------------------------------------| +| experimental | prerelease | {applies_to}`stack: experimental 99.99`| +| | post-release | {applies_to}`stack: experimental 9.1` | +| preview | prerelease | {applies_to}`stack: preview 99.99` | +| | post-release | {applies_to}`stack: preview 9.1` | +| ga | prerelease | {applies_to}`stack: ga 99.99` | +| | post-release | {applies_to}`stack: ga 9.1` | +| deprecated | prerelease | {applies_to}`stack: deprecated 99.99` | +| | post-release | {applies_to}`stack: deprecated 9.1` | +| removed | prerelease | {applies_to}`stack: removed 99.99` | +| | post-release | {applies_to}`stack: removed 9.1` | This is computed at build time. The documentation team tracks and maintains released versions for these products centrally in [`versions.yml`](https://github.com/elastic/docs-builder/blob/main/config/versions.yml). diff --git a/contribute-docs/how-to/cumulative-docs/guidelines.md b/contribute-docs/how-to/cumulative-docs/guidelines.md index dcec72a6e2..b5b04af149 100644 --- a/contribute-docs/how-to/cumulative-docs/guidelines.md +++ b/contribute-docs/how-to/cumulative-docs/guidelines.md @@ -278,7 +278,7 @@ For versioned products like the Elastic Stack: % ([example](example-scenarios.md#)) * When a feature in a versioned product changes lifecycle state, append the new lifecycle state and the version in which the state changed to the relevant key in `applies_to`. - This applies to all lifecycle states including `preview`, `beta`, `ga`, `deprecated`, and `removed` + This applies to all lifecycle states including `preview`, `ga`, `deprecated`, `experimental`, and `removed` ([example](example-scenarios.md#lifecycle-changed)). diff --git a/get-started/versioning-availability.md b/get-started/versioning-availability.md index 0993ceec3a..edf36797b3 100644 --- a/get-started/versioning-availability.md +++ b/get-started/versioning-availability.md @@ -125,8 +125,8 @@ Available features can differ based on deployment type, product lifecycle stage, | Lifecycle state | Description | | ----- | ----- | -| Technical preview | Feature is in early development stage | -| Beta | Feature is nearing general availability, but not yet production ready | +| Experimental | Feature is in early development stage and might change or be removed at any time | +| Technical preview | Feature is nearing general availability and ready for evaluation. Use with caution in production. | | Generally Available (GA) | Production-ready feature. When unspecified, GA is the default | | Deprecated | Feature is still usable, but is planned to be removed or replaced in a future update | | Removed | Feature can no longer be used |