Add new Elastic intro section

deploy-manage/deploy.md

@@ -24,7 +24,7 @@ In most cases, you also need to deploy **{{kib}}**. {{kib}} provides the user in
 Your choice of deployment type determines how you'll set up and manage these core components, as well as any additional components you need.
 
 :::{admonition} Other {{stack}} components
-This section focuses on deploying and managing {{es}} and {{kib}}, as well as supporting orchestration technologies. However, depending on your use case, you might need to deploy [other {{stack}} components](/get-started/the-stack.md). For example, you might need to add components to ingest logs or metrics.
+This section focuses on deploying and managing {{es}} and {{kib}}, as well as supporting orchestration technologies. However, depending on your use case, you might need to deploy [other components](/get-started/search-ai-platform.md). For example, you might need to add components to ingest logs or metrics.
 
 To learn how to deploy optional {{stack}} components, refer to the following sections:
 * [Fleet and Elastic Agent](/reference/fleet/index.md)
@@ -89,6 +89,9 @@ Consider this when choosing your deployment type:
 - Choose {{serverless-full}} if you want automatic access to the latest features and don't want to manage version compatibility
 - Choose other deployment types if you need more control over version management
 
+:::{include} /deploy-manage/deploy/_snippets/stack-version-compatibility.md
+:::
+
 :::{tip}
 Learn more about [versioning and availability](/get-started/versioning-availability.md).
 :::

deploy-manage/deploy/cloud-on-k8s/kibana-instance-quickstart.md

@@ -11,7 +11,7 @@ products:
 
 # Deploy a {{kib}} instance [k8s-deploy-kibana]
 
-To deploy a simple [{{kib}}](/get-started/the-stack.md#stack-components-kibana) specification, with one {{kib}} instance:
+To deploy a simple {{kib}} specification, with one {{kib}} instance:
 
 1. Specify a {{kib}} instance and associate it with your {{es}} `quickstart` cluster created previously under [Deploying an {{es}} cluster](elasticsearch-deployment-quickstart.md):
 

deploy-manage/deploy/self-managed.md

@@ -29,11 +29,17 @@ Self-hosted options:
 For a comparison of these deployment options, refer to [Choosing your deployment type](/deploy-manage/deploy.md#choosing-your-deployment-type) and [](/deploy-manage/deploy/deployment-comparison.md).
 :::
 
+## Installation order
+
+:::{include} /deploy-manage/deploy/_snippets/installation-order.md
+:::
+
 ## Section overview
 
 This section focuses on deploying {{es}} and {{kib}} without an orchestrator.
 
-Depending on your use case, you might need to deploy other components, such as APM, Fleet, or Logstash. Deploying those components is not covered in this section. [Learn more about optional components](/get-started/the-stack.md).
+Depending on your use case, you might need to deploy other components, such as APM, Fleet, or Logstash.
+Deploying those components is not covered in this section. [Learn more about optional components](/get-started/search-ai-platform.md).
 
 This section covers the following tasks:
 

deploy-manage/deploy/self-managed/_snippets/install-next-steps.md

@@ -6,7 +6,7 @@ You now have a test {{es}} environment set up. Before you start serious developm
 
 You can also do the following:
 
-* Consider installing [additional {{stack}} components](/get-started/the-stack.md).
+* Consider installing [additional {{stack}} components](/get-started/search-ai-platform.md).
 * Learn how to [ingest data into {{es}}](/manage-data/index.md).
 * Learn about [production considerations](/deploy-manage/production-guidance.md).
 * Explore [other topics](/deploy-manage/deploy/self-managed.md#other-important-sections) to learn how to secure and manage your cluster.

deploy-manage/deploy/self-managed/_snippets/ports.md

@@ -10,4 +10,4 @@ These settings can be overridden in the relevant configuration file.
 | 9300 and onwards | TCP |	Transport API. Used for intra-cluster communications and client access via the transport API (Java client). | Elasticsearch [`transport.port`](elasticsearch://reference/elasticsearch/configuration-reference/networking-settings.md#common-network-settings) |
 | 5601 | HTTP |	{{kib}} default access port. | Kibana [`server.port`](kibana://reference/configuration-reference/general-settings.md#server-port) |
 
-Additional ports might be required for [optional {{stack}} components](/get-started/the-stack.md). Refer to the installation guide for the component that you want to install.
+Additional ports might be required for [optional {{stack}} components](/get-started/search-ai-platform.md). Refer to the installation guide for the component that you want to install.

deploy-manage/index.md

@@ -17,7 +17,7 @@ To get started with Elastic, you need to choose a deployment method and deploy {
 
 In this section, you'll learn about how to deploy and manage all aspects of your Elastic environment. You'll learn how to design resilient, highly available clusters and deployments, and how to maintain and scale your environment to grow with your use case.
 
-This section focuses on deploying and managing the core components of the {{stack}}: {{es}} and {{kib}}. It also documents deploying and managing supporting orchestration technologies. However, depending on your use case, you might need to deploy other components. [Learn more](/get-started/the-stack.md).
+This section focuses on deploying and managing the core components of the {{stack}}: {{es}} and {{kib}}. It also documents deploying and managing supporting orchestration technologies. However, depending on your use case, you might need to deploy other components. [Learn more](/get-started/search-ai-platform.md).
 
 :::{tip}
 To get started quickly, you can set up a [local development and testing environment](/deploy-manage/deploy/self-managed/local-development-installation-quickstart.md), or sign up for a [Serverless](https://cloud.elastic.co/serverless-registration) or [Hosted](https://cloud.elastic.co/registration) trial in {{ecloud}}.

deploy-manage/production-guidance/elasticsearch-in-production-environments.md

@@ -64,7 +64,7 @@ The following topics, covered in other sections of the documentation, offer valu
 
 ### Security and monitoring [security-and-monitoring]
 
-As with any enterprise system, you need tools to secure, manage, and monitor your deployments. Security, monitoring, and administrative features that are integrated into {{es}} enable you to use [Kibana](/get-started/the-stack.md) as a control center for managing a cluster.
+As with any enterprise system, you need tools to secure, manage, and monitor your deployments. Security, monitoring, and administrative features that are integrated into {{es}} enable you to use {{kib}} as a control center for managing a cluster.
 
 * [Learn about securing an {{es}} cluster](../security.md)
 

docset.yml

@@ -295,3 +295,4 @@ subs:
   ece-apis: https://www.elastic.co/docs/api/doc/cloud-enterprise/
   intake-apis: https://www.elastic.co/docs/api/doc/observability-serverless/
   models-app: "Trained Models"
+  search-platform: "Search AI Platform"

explore-analyze/alerts-cases/alerts/view-alerts.md

@@ -109,7 +109,7 @@ The alert cleanup task permanently deletes alerts in your `.alert-*` indices. Ma
 
 Remove old or rarely-accessed alerts in your space by running an alert cleanup task, which deletes alerts according to the criteria that you define. Alerts that are attached to cases are not deleted. 
 
-1. Open the **Rules** page by going to **Stack Management > Alerts and Insights > Rules** in the main menu or using the global search field.
+1. Open the **Rules** page by going to **Stack Management > Alerts and Insights > Rules** in the main menu or using the [global search field](/explore-analyze/find-and-organize/find-apps-and-objects.md).
 2. Click **Settings** to open the settings for all rules in the space.
 3. In the **Clean up alert history** section, click **Clean up**.
 4. Define criteria for the alert cleanup task. You can choose to delete alerts that are active or inactive and meet a certain age.

explore-analyze/query-filter/aggregations/tutorial-analyze-ecommerce-data-with-aggregations-using-query-dsl.md

@@ -34,7 +34,7 @@ You’ll need:
 
 2. The [sample eCommerce data](../../index.md#gs-get-data-into-kibana) loaded into {{es}}. To load sample data follow these steps in your UI:
 
-    * Open the **Integrations** pages by searching in the global search field.
+    * Open the **Integrations** pages by searching in the [global search field](/explore-analyze/find-and-organize/find-apps-and-objects.md).
     * Search for `sample data` in the **Integrations** search field.
     * Open the **Sample data** page.
     * Select the **Other sample data sets** collapsible.

extend/index.md

@@ -1,26 +1,58 @@
-# Extend and contribute
+# Extend and contribute 
 
-This section contains information on how to extend or contribute to our various products.
+You can extend and build on the Elastic Platform in several ways. Whether you need to get data into Elasticsearch, add new functionality, edit the documentation, or build a custom application, here is an overview of the primary development paths to help you choose the right one for your project.
 
-## Contributing to Elastic documentation
+There are two main approaches to extending Elastic: creating standardized Integrations for data ingestion or building custom solutions by developing directly against our REST APIs.
+
+## Path 1: Create an Elastic Integration
+
+If your primary goal is to bring a new data source into the Elastic Stack in a standardized, reusable way, building an Elastic Integration is the best path. Integrations are pre-packaged assets that make it simple for users to collect and process data from a specific service or platform.
+
+This approach is ideal for shipping data, logs, metrics, and traces. By building an integration, you contribute to the ever-growing ecosystem that both you and the community can benefit from.
+
+* Integrations are built on a consistent framework, providing users with a turnkey experience, including dashboards, visualizations, and alerts.  
+* **`elastic-package`** is a command-line tool that is your primary interface for creating, testing, and packaging your integration. It scaffolds the entire project structure, letting you focus on the logic for data collection.  
+* Your integration will run on the Elastic Agent, our single, unified agent for data shipping.
+
+**When to choose this path**
 
-You can contribute to the Elastic documentation in several ways.
+* You want to ingest data from a new data source, like a database, API, or log file.  
+* You want to provide a standardized, out-of-the-box experience for other users.  
+* You need to process and structure data according to the Elastic Common Schema (ECS).
 
-Refer to [Contribute to Elastic documentation](./contribute/index.md) for an overview.
+**Ready to start?** Head over to the [Create an Integration](integrations://extend/index.md) guide.
 
-## Contributing to Elastic Projects
+## Path 2: Develop against the REST APIs
 
-You can contribute to various projects, including:
+For complete control and custom development, you can interact directly with Elastic's REST APIs. This path is perfect for building custom applications, automating complex workflows, and integrating Elastic into your existing infrastructure in a bespoke way. For example, you can programmatically manage your cluster, run complex queries, manage security settings, and interact with Kibana.
 
-- [Kibana](kibana://extend/index.md): Enhance our data visualization platform by contributing to Kibana.
-- [Logstash](logstash://extend/index.md): Help us improve the data processing pipeline with your contributions to Logstash.
-- [Beats](beats://extend/index.md): Add new features or beats to our lightweight data shippers.
+* The APIs provide direct access to the core capabilities of Elasticsearch and Kibana. If you can do it in the UI, you can automate it with the API.  
+* Elastic provides and supports official clients for popular languages like Java, Go, .NET, PHP, Python, Ruby, and JavaScript. These clients simplify interacting with the API, handling requests, and processing responses.  
+* The APIs are secured using role-based access control (RBAC). You can create API keys or use bearer tokens with fine-grained permissions to ensure your interactions are safe.
 
-## Creating Integrations
+### Elastic APIs at a glance
 
-Extend the capabilities of Elastic by creating integrations that connect Elastic products with other tools and systems. Visit our [Integrations Guide](integrations://extend/index.md) to get started.
+* Use the Elasticsearch APIs to:
 
-## Elasticsearch Plugins
+  * Create, read, update, and delete documents.  
+  * Perform everything from simple keyword searches to complex analytical aggregations.  
+  * Monitor cluster health, manage nodes, and configure settings.  
+  * Manage users, roles, and API keys.  
 
-Develop custom plugins to add new functionalities to Elasticsearch. Check out our [Elasticsearch Plugins Development Guide](elasticsearch://extend/index.md) for detailed instructions and best practices.
+* Use the Kibana APIs to programmatically control the Kibana front-end and its objects:
+
+  * Create and manage dashboards, visualizations, and saved searches.  
+  * Automate the organization of content within Kibana.  
+  * Create and manage rules for detecting conditions within your data.
+
+**When to choose this path**
+
+* You are building a custom application that uses Elasticsearch as its backend.  
+* You need to automate administrative tasks, such as creating users or managing index lifecycle policies.  
+* You are integrating Elastic's search and analytics capabilities into another platform.
+
+Ready to get started? Explore the [Elasticsearch API Reference](elasticsearch://reference/elasticsearch/rest-apis/index.md) and the [Kibana API Reference](https://www.elastic.co/docs/api/doc/kibana/).
+
+## Contributing to Elastic documentation
 
+You can contribute to the Elastic documentation in several ways. Refer to [Contribute to Elastic documentation](./contribute/index.md) for an overview.

get-started/deployment-options.md

@@ -1,17 +1,41 @@
 ---
+navigation_title: Deployment options
 mapped_pages:
   - https://www.elastic.co/guide/en/elasticsearch/reference/current/elasticsearch-intro-deploy.html
 products:
   - id: elasticsearch
+applies_to:
+  serverless:
+  stack:
 ---
 
-# Deployment options [elasticsearch-intro-deploy]
+# Deployment options
+
+You can run Elastic on any infrastructure, allowing you to select the model that best fits your operational needs.
 
 Use this page for a quick overview of your options for deploying Elastic.
 
-:::{include} /deploy-manage/_snippets/deployment-options-overview.md
-:::
+## Why your deployment choice matters
+
+Your deployment type significantly impacts both the capabilities available across your Elastic environment and the amount of manual work required to set up and maintain it. Some deployment types provide automated orchestration that handles scaling, upgrades, and monitoring across multiple clusters, while others require you to manage these operational tasks manually. 
+
+The choice you make determines how much time you'll spend on infrastructure management versus focusing on using Elastic's features to solve your business problems.
+
+## Quick start options
+
+These are the most common deployment types and their main features:
+
+* **[{{ecloud}}](/deploy-manage/deploy/elastic-cloud.md)**: Get a hosted solution up and running in minutes.
+  * **[{{ech}}](/deploy-manage/deploy/elastic-cloud/cloud-hosted.md)**: This managed SaaS offering managed through [{{ecloud}}](/deploy-manage/deploy/elastic-cloud.md) provides you with a dedicated cluster on your choice of cloud provider (AWS, GCP, or Azure). It offers a high degree of control over your cluster's configuration, allowing you to fine-tune nodes, hardware, and versions to meet specific performance and architectural requirements. Sign up for a [14-day free trial](https://cloud.elastic.co/registration).
+  * **[{{serverless-full}}](/deploy-manage/deploy/elastic-cloud/serverless.md)**: This fully managed SaaS offering managed through [{{ecloud}}](/deploy-manage/deploy/elastic-cloud.md) abstracts away all underlying infrastructure, automatically and seamlessly scaling resources to meet your workload demands. It's designed for operational simplicity, with usage-based pricing that allows you to focus on your data without managing clusters. Sign up for a [14-day free trial](https://cloud.elastic.co/serverless-registration).
+* **[Local development](/deploy-manage/deploy/self-managed/local-development-installation-quickstart.md)**: Get started quickly with {{es}} and {{kib}} in Docker for local development and testing.
+
+## Advanced options
+
+* **[Self-managed](/deploy-manage/deploy/self-managed.md)**: This approach allows you to install, operate, and maintain components of the {{search-platform}} on your own hardware, whether on-premises or in your private cloud. It provides maximum control over your environment.
+* **[{{ece}}](/deploy-manage/deploy/cloud-enterprise.md)**: This Elastic self-managed offering allows you to provision, manage, and monitor components of the {{search-platform}} at any scale, on any infrastructure, while managing everything from a single console.
+* **[{{eck}}](/deploy-manage/deploy/cloud-on-k8s.md)**: This extends Kubernetes by providing an official operator for deploying and managing components of the {{search-platform}}. It's ideal if you want to run and orchestrate Elastic on your own Kubernetes platform.
 
 :::{tip}
-Refer to [](/deploy-manage/index.md) for detailed information and guidance on choosing the right deployment for your needs.
+Refer to [Deploy and manage](/deploy-manage/index.md) for detailed information and guidance on selecting the right deployment for your needs.
 :::