Skip to content

Commit 361dd92

Browse files
lcawllcawl
committed
Update versioning and availability
1 parent c22245d commit 361dd92

File tree

1 file changed

+32
-33
lines changed

1 file changed

+32
-33
lines changed

‎get-started/versioning-availability.md‎

Lines changed: 32 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -2,20 +2,24 @@
22
navigation_title: Versioning and availability
33
mapped_pages:
44
- https://www.elastic.co/guide/en/starting-with-the-elasticsearch-platform-and-its-solutions/current/introducing-elastic-documentation.html
5+
applies_to:
6+
serverless:
7+
stack:
58
products:
69
- id: elastic-stack
710
description: Learn how Elastic handles versioning and feature availability in the docs. Find the product versions that are supported, how to read availability badges, and...
811
---
912

10-
# Versioning and availability in Elastic Docs
13+
# Versioning and availability
1114

12-
Learn how Elastic Docs handles versioning, feature availability, and how to find the right documentation for your deployment type and product version. Find answers to common questions about the Elastic Stack versioning and confidently navigate our continuously updated documentation.
15+
Learn how Elastic products are versioned, the lifecycle of features, and how to find the right documentation for your deployment type and product version. Find answers to common questions about the versioning and confidently navigate our continuously updated documentation.
1316

14-
## Frequently asked questions
17+
## Understanding versioning
1518

16-
### Where can I find documentation for the latest version of the {{stack}}?
19+
Many components of the [{{stack}}](/get-started/the-stack.md) (such as {{es}} and {{kib}}) share the same versioning pattern.
20+
In the documentation, this group of components is typically referred to as the {{stack}}.
1721

18-
You’re in the right place! All documentation for Elastic Stack 9.0.0 and later is available at [elastic.co/docs](https://www.elastic.co/docs), including the latest {{version.stack| M.M}} version and any future versions in the 9.x series.
22+
Orchestrators such as {{ece}} and {{eck}}, and other tools such as code clients and SDKs, are versioned independently of the {{stack}}. The {{ecloud}} console and {{serverless-short}} projects are always automatically updated with the latest changes.
1923

2024
Need docs for an earlier version? Go to [elastic.co/guide](https://www.elastic.co/guide).
2125

@@ -91,45 +95,47 @@ To make sure you're always viewing the most up-to-date and relevant documentatio
9195

9296
## Understanding {{stack}} versioning
9397

94-
{{stack}} uses semantic versioning in the `X.Y.Z` format, such as `9.0.0`.
98+
The components of the {{stack}} typically use semantic versioning in the `X.Y.Z` format, such as `9.0.0`.
9599

96100
| Version | Description |
97-
|-------|-------------|
98-
| **Major (X)** | Indicates significant changes, such as new features, breaking changes, and major enhancements. Upgrading to a new major version may require changes to your existing setup and configurations. |
99-
| **Minor (Y)** | Introduces new features and improvements, while maintaining backward compatibility with the previous minor versions within the same major version. Upgrading to a new minor version should not require any changes to your existing setup. |
100-
| **Patch (Z)** | Contains bug fixes and security updates, without introducing new features or breaking changes. Upgrading to a new patch version should be seamless and not require any changes to your existing setup. |
101+
| ----- | ----- |
102+
| Major (X) | Indicates significant changes, such as new features, breaking changes, and major enhancements. Upgrading to a new major version may require changes to your existing setup and configurations. |
103+
| Minor (Y) | Introduces new features and improvements, while maintaining backward compatibility with the previous minor versions within the same major version. Upgrading to a new minor version should not require any changes to your existing setup. |
104+
| Patch (Z) | Contains bug fixes and security updates, without introducing new features or breaking changes. Upgrading to a new patch version should be seamless and not require any changes to your existing setup. |
101105

102-
Understanding {{stack}} versioning is essential for [upgrade planning](/deploy-manage/upgrade.md) and ensuring compatibility.
106+
Understanding versioning is essential for [upgrade planning](/deploy-manage/upgrade.md) and ensuring compatibility, particularly in the self-managed [deployment option](/get-started/deployment-options.md).
103107

104108
## Availability of features
105109

106-
The features available to you can differ based on deployment type, product lifecycle stage, and specific version.
110+
Available features can differ based on deployment type, product lifecycle stage, and specific version.
107111

108112
### Feature availability factors
109113

110114
| Factor | Description |
111-
|-------|-------------|
112-
| **Deployment type** | The environment where the feature is available, for example, {{stack}}, {{serverless-full}}, {{ece}} (ECE), {{eck}} (ECK) |
113-
| **Lifecycle state** | The development or support status of the feature, for example, GA and Beta |
114-
| **Version** | The specific version the lifecycle state applies to |
115+
| ----- | ----- |
116+
| Deployment type | The environment where the feature is available, for example, self-managed, {{serverless-full}}, {{ece}}, {{eck}} |
117+
| Lifecycle state | The development or support status of the feature, for example, GA, Technical preview, Beta |
118+
| Version | The specific version the lifecycle state applies to |
115119

116120
### Lifecycle states
117121

118122
| Lifecycle state | Description |
119-
|-------|-------------|
120-
| **Generally Available (GA)** | Production-ready feature. When unspecified, GA is the default |
121-
| **Beta** | Feature is nearing general availability but not yet production-ready |
122-
| **Technical preview** | Feature is in early development stage |
123-
| **Unavailable** | Feature is not supported in this deployment type or version |
123+
| ----- | ----- |
124+
| Technical preview | Feature is in early development stage |
125+
| Beta | Feature is nearing general availability, but not yet production ready |
126+
| Generally Available (GA) | Production-ready feature. When unspecified, GA is the default |
127+
| Deprecated | Feature is still usable, but is planned to be removed or replaced in a future update |
128+
| Removed | Feature can no longer be used |
129+
| Unavailable | Feature is unsupported in this deployment type or version |
124130

125131
### Examples of where availability can vary
126132

127133
| Category | Example |
128-
|-------|-------------|
129-
| **Elastic Stack versions** | [Elastic Stack](the-stack.md) version 9.0.0 and later, including 9.1.0 |
130-
| **Deployment types** | [Elastic Cloud Serverless](/deploy-manage/deploy/elastic-cloud/serverless.md), [Elastic Cloud Hosted](/deploy-manage/deploy/elastic-cloud/cloud-hosted.md), [Elastic Cloud Enterprise (ECE)](/deploy-manage/deploy/cloud-enterprise.md), [Elastic Cloud on Kubernetes (ECK)](/deploy-manage/deploy/cloud-on-k8s.md), and [Self-managed deployments](/deploy-manage/deploy/self-managed.md) |
131-
| **Deployment versions** | [Elastic Cloud Enterprise (ECE)](/deploy-manage/deploy/cloud-enterprise.md) 4.0.0 and later, [Elastic Cloud on Kubernetes (ECK)](/deploy-manage/deploy/cloud-on-k8s.md) 3.0.0 and later |
132-
| **Serverless project types** | {{es}}, {{observability}}, and {{elastic-sec}}
134+
| ----- | ----- |
135+
| {{stack}} versions | [{{stack}}](/get-started/the-stack.md) version 9.0.0 and later, including 9.1.0 |
136+
| Deployment types | [{{serverless-full}}](/deploy-manage/deploy/elastic-cloud/serverless.md), [{{ech}}](/deploy-manage/deploy/elastic-cloud/cloud-hosted.md), [{{ece}}](/deploy-manage/deploy/cloud-enterprise.md), [{{eck}}](/deploy-manage/deploy/cloud-on-k8s.md), and [Self-managed deployments](/deploy-manage/deploy/self-managed.md) |
137+
| Orchestrator versions | [{{ece}}](/deploy-manage/deploy/cloud-enterprise.md) 4.0.0 and later, [{{eck}}](/deploy-manage/deploy/cloud-on-k8s.md) 3.0.0 and later |
138+
| Serverless project types | {{es}}, Elastic {{observability}}, and {{elastic-sec}} |
133139

134140
## Find docs for your product version
135141

@@ -207,10 +213,3 @@ Find the documentation for your Elastic product versions or releases.
207213
| [Elastic APM AWS Lambda extension](apm-aws-lambda://release-notes/release-notes.md) | 1.0.0 and later |
208214
| [Elastic APM Attacher for Kubernetes](apm-k8s-attacher://reference/index.md) | 1.1.3 |
209215

210-
211-
212-
213-
214-
215-
216-

0 commit comments

Comments
 (0)