|
2 | 2 | navigation_title: Versioning and availability |
3 | 3 | mapped_pages: |
4 | 4 | - 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: |
8 | 5 | products: |
9 | 6 | - id: elastic-stack |
10 | 7 | 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... |
11 | 8 | --- |
12 | 9 |
|
13 | | -# Versioning and availability |
| 10 | +# Versioning and availability in Elastic Docs |
14 | 11 |
|
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. |
| 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. |
16 | 13 |
|
17 | | -## Understanding versioning |
| 14 | +## Frequently asked questions |
18 | 15 |
|
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}}. |
| 16 | +### Where can I find documentation for the latest version of the {{stack}}? |
21 | 17 |
|
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. |
| 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. |
23 | 19 |
|
24 | 20 | Need docs for an earlier version? Go to [elastic.co/guide](https://www.elastic.co/guide). |
25 | 21 |
|
@@ -95,47 +91,45 @@ To make sure you're always viewing the most up-to-date and relevant documentatio |
95 | 91 |
|
96 | 92 | ## Understanding {{stack}} versioning |
97 | 93 |
|
98 | | -The components of the {{stack}} typically use semantic versioning in the `X.Y.Z` format, such as `9.0.0`. |
| 94 | +{{stack}} uses semantic versioning in the `X.Y.Z` format, such as `9.0.0`. |
99 | 95 |
|
100 | 96 | | Version | Description | |
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. | |
| 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. | |
105 | 101 |
|
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). |
| 102 | +Understanding {{stack}} versioning is essential for [upgrade planning](/deploy-manage/upgrade.md) and ensuring compatibility. |
107 | 103 |
|
108 | 104 | ## Availability of features |
109 | 105 |
|
110 | | -Available features can differ based on deployment type, product lifecycle stage, and specific version. |
| 106 | +The features available to you can differ based on deployment type, product lifecycle stage, and specific version. |
111 | 107 |
|
112 | 108 | ### Feature availability factors |
113 | 109 |
|
114 | 110 | | Factor | Description | |
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 | |
| 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 | |
119 | 115 |
|
120 | 116 | ### Lifecycle states |
121 | 117 |
|
122 | 118 | | Lifecycle state | Description | |
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 | |
| 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 | |
130 | 124 |
|
131 | 125 | ### Examples of where availability can vary |
132 | 126 |
|
133 | 127 | | Category | Example | |
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}} | |
| 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}} |
139 | 133 |
|
140 | 134 | ## Find docs for your product version |
141 | 135 |
|
@@ -213,3 +207,10 @@ Find the documentation for your Elastic product versions or releases. |
213 | 207 | | [Elastic APM AWS Lambda extension](apm-aws-lambda://release-notes/release-notes.md) | 1.0.0 and later | |
214 | 208 | | [Elastic APM Attacher for Kubernetes](apm-k8s-attacher://reference/index.md) | 1.1.3 | |
215 | 209 |
|
| 210 | + |
| 211 | + |
| 212 | + |
| 213 | + |
| 214 | + |
| 215 | + |
| 216 | + |
0 commit comments