Move the “Providers" docs out of the standalone Elastic Agent docs

reference/fleet/agent-provider.md

@@ -1,6 +1,8 @@
 ---
 mapped_pages:
   - https://www.elastic.co/guide/en/fleet/current/agent-provider.html
+applies_to:
+  stack: ga
 products:
   - id: fleet
   - id: elastic-agent

reference/fleet/docker-provider.md

@@ -1,12 +1,14 @@
 ---
 mapped_pages:
   - https://www.elastic.co/guide/en/fleet/current/docker-provider.html
+applies_to:
+  stack: ga
 products:
   - id: fleet
   - id: elastic-agent
 ---
 
-# Docker Provider [docker-provider]
+# Docker provider [docker-provider]
 
 Provides inventory information from Docker. The available dynamic variables are:
 

reference/fleet/env-provider.md

@@ -1,12 +1,14 @@
 ---
 mapped_pages:
   - https://www.elastic.co/guide/en/fleet/current/env-provider.html
+applies_to:
+  stack: ga
 products:
   - id: fleet
   - id: elastic-agent
 ---
 
-# Env Provider [env-provider]
+# Env provider [env-provider]
 
 Provides access to the environment variables as key-value pairs.
 

reference/fleet/filesource-provider.md

@@ -1,3 +1,11 @@
+---
+applies_to:
+  stack: ga
+products:
+  - id: fleet
+  - id: elastic-agent
+---
+
 # Filesource provider [filesource-provider]
 
 Watches for changes of specified files and updates the values of the variables when the content of the files changes.

reference/fleet/host-provider.md

@@ -1,6 +1,8 @@
 ---
 mapped_pages:
   - https://www.elastic.co/guide/en/fleet/current/host-provider.html
+applies_to:
+  stack: ga
 products:
   - id: fleet
   - id: elastic-agent

reference/fleet/kubernetes-provider.md

@@ -1,12 +1,14 @@
 ---
 mapped_pages:
   - https://www.elastic.co/guide/en/fleet/current/kubernetes-provider.html
+applies_to:
+  stack: ga
 products:
   - id: fleet
   - id: elastic-agent
 ---
 
-# Kubernetes Provider [kubernetes-provider]
+# Kubernetes provider [kubernetes-provider]
 
 Provides inventory information from Kubernetes.
 

reference/fleet/kubernetes_leaderelection-provider.md

@@ -1,6 +1,8 @@
 ---
 mapped_pages:
   - https://www.elastic.co/guide/en/fleet/current/kubernetes_leaderelection-provider.html
+applies_to:
+  stack: ga
 products:
   - id: fleet
   - id: elastic-agent

reference/fleet/kubernetes_secrets-provider.md

@@ -1,12 +1,14 @@
 ---
 mapped_pages:
   - https://www.elastic.co/guide/en/fleet/current/kubernetes_secrets-provider.html
+applies_to:
+  stack: ga
 products:
   - id: fleet
   - id: elastic-agent
 ---
 
-# Kubernetes Secrets Provider [kubernetes_secrets-provider]
+# Kubernetes Secrets provider [kubernetes_secrets-provider]
 
 Provides access to the Kubernetes Secrets API.
 

reference/fleet/local-dynamic-provider.md

@@ -1,6 +1,8 @@
 ---
 mapped_pages:
   - https://www.elastic.co/guide/en/fleet/current/local-dynamic-provider.html
+applies_to:
+  stack: ga
 products:
   - id: fleet
   - id: elastic-agent

reference/fleet/local-provider.md

@@ -1,12 +1,14 @@
 ---
 mapped_pages:
   - https://www.elastic.co/guide/en/fleet/current/local-provider.html
+applies_to:
+  stack: ga
 products:
   - id: fleet
   - id: elastic-agent
 ---
 
-# Local [local-provider]
+# Local provider [local-provider]
 
 Provides custom keys to use as variables. For example:
 

reference/fleet/providers.md

@@ -1,25 +1,46 @@
 ---
-navigation_title: Providers
+navigation_title: Agent providers
 mapped_pages:
   - https://www.elastic.co/guide/en/fleet/current/providers.html
+applies_to:
+  stack: ga
 products:
   - id: fleet
   - id: elastic-agent
 ---
 
-# Configure providers for standalone {{agent}}s [providers]
+# {{agent}} providers [providers]
 
 
-Providers supply the key-value pairs that are used for variable substitution and conditionals. Each provider’s keys are automatically prefixed with the name of the provider in the context of the {{agent}}.
+Providers supply the key-value pairs that are used for variable substitution and conditionals. Each provider's keys are automatically prefixed with the name of the provider in the context of the {{agent}}.
 
-For example, a provider named `foo` provides `{"key1": "value1", "key2": "value2"}`, the key-value pairs are placed in `{"foo" : {"key1": "value1", "key2": "value2"}}`. To reference the keys, use `{{foo.key1}}` and `{{foo.key2}}`.
+For example, if a provider named `foo` provides `{"key1": "value1", "key2": "value2"}`, the key-value pairs are placed in `{"foo" : {"key1": "value1", "key2": "value2"}}`. To reference the keys, use the variables `${foo.key1}` and `${foo.key2}`.
 
 
-## Provider configuration [_provider_configuration]
+## Provider usage by deployment model [provider_usage_by_deployment_model]
 
-The provider configuration is specified under the top-level `providers` key in the `elastic-agent.yml` configuration. All registered providers are enabled by default. If a provider cannot connect, no mappings are produced.
+How you use providers depends on whether you're running a standalone or a {{fleet}}-managed {{agent}}.
 
-The following example shows two providers (`local` and `local_dynamic`) that supply custom keys:
+### Using providers on standalone {{agent}} [using-providers-standalone-agent]
+
+On standalone {{agent}}, providers can be configured through the `providers` key in the `elastic-agent.yml` configuration file. By default, all providers are enabled, but {{agent}} runs them only if they are referenced in the configuration file or in an {{agent}} policy. Disabled providers are not run even if they are referenced.
+
+You can enable, disable, and configure provider settings as needed. For more details, refer to [Provider configuration](#provider_configuration).
+
+### Using providers on {{fleet}}-managed {{agent}} [using-providers-fleet-managed-agent]
+
+On {{fleet}}-managed {{agent}}, you can use provider variables in integration policy settings (for example, `${host.name}`, `${env.foo}`, `${agent.id}`), but you cannot add a `providers` configuration block directly through the {{fleet}} UI.
+
+Some providers can be configured on {{k8s}} deployments using ConfigMaps. For more details, refer to [Advanced {{agent}} configuration managed by {{fleet}}](/reference/fleet/advanced-kubernetes-managed-by-fleet.md).
+
+
+## Provider configuration [provider_configuration]
+
+On standalone {{agent}}, provider configuration is specified under the top-level `providers` key in the `elastic-agent.yml` configuration file. All registered providers are enabled by default but they are run by {{agent}} only if they are referenced. If a provider cannot connect, no mappings are produced.
+
+All providers are prefixed without name collisions. The name of the provider is in the key in the configuration.
+
+The following example shows two providers (`local` and `local_dynamic`) that supply custom keys on a standalone {{agent}}:
 
 ```yaml
 providers:
@@ -36,14 +57,16 @@ providers:
           item: key3
 ```
 
-Providers are enabled automatically if a provider is referenced in an {{agent}} policy. All providers are prefixed without name collisions. The name of the provider is in the key in the configuration.
+If a provider is referenced in an {{agent}} policy, it is turned on automatically unless it's explicitly disabled in the `elastic-agent.yml` configuration file. For example, to disable the Docker provider in a standalone {{agent}}, set:
 
 ```yaml
 providers:
   docker:
     enabled: false
 ```
 
+With this setting, {{agent}} will not run the Docker provider even if it's referenced in an {{agent}} policy.
+
 {{agent}} supports two broad types of providers: [context](#context-providers) and [dynamic](#dynamic-providers).
 
 
@@ -53,50 +76,40 @@ Context providers give the current context of the running {{agent}}, for example
 
 They can only provide a single key-value mapping. Think of them as singletons; an update of a key-value mapping results in a re-evaluation of the entire configuration. These providers are normally very static, but not required. A value can change which results in re-evaluation.
 
-Context providers use the Elastic Common Schema (ECS) naming to ensure consistency and understanding throughout documentation and projects.
+Context providers use the {{product.ecs}} naming to ensure consistency and understanding throughout documentation and projects.
 
 {{agent}} supports the following context providers:
 
-* [Local](/reference/fleet/local-provider.md)
-* [Agent Provider](/reference/fleet/agent-provider.md)
-* [Host Provider](/reference/fleet/host-provider.md)
-* [Env Provider](/reference/fleet/env-provider.md)
-* [Kubernetes Secrets Provider](/reference/fleet/kubernetes_secrets-provider.md)
-* [Kubernetes Leader Election Provider](/reference/fleet/kubernetes_leaderelection-provider.md)
+* [Local provider](/reference/fleet/local-provider.md)
+* [Agent provider](/reference/fleet/agent-provider.md)
+* [Host provider](/reference/fleet/host-provider.md)
+* [Env provider](/reference/fleet/env-provider.md)
+* [Kubernetes Secrets provider](/reference/fleet/kubernetes_secrets-provider.md)
+* [Kubernetes LeaderElection provider](/reference/fleet/kubernetes_leaderelection-provider.md)
 
 
-### Dynamic Providers [dynamic-providers]
+### Dynamic providers [dynamic-providers]
 
 Dynamic providers give an array of multiple key-value mappings. Each key-value mapping is combined with the previous context provider’s key and value mapping which provides a new unique mapping that is used to generate a configuration.
 
 {{agent}} supports the following context providers:
 
-* [Local Dynamic Provider](/reference/fleet/local-dynamic-provider.md)
-* [Docker Provider](/reference/fleet/docker-provider.md)
-* [Kubernetes Provider](/reference/fleet/kubernetes-provider.md)
+* [Local dynamic provider](/reference/fleet/local-dynamic-provider.md)
+* [Docker provider](/reference/fleet/docker-provider.md)
+* [Kubernetes provider](/reference/fleet/kubernetes-provider.md)
 
 
-### Disabling Providers By Default [disable-providers-by-default]
+### Disabling providers by default [disable-providers-by-default]
 
-All registered providers are disabled by default until they are referenced in a policy.
+Registered providers are run by {{agent}} if they are referenced in the {{agent}} configuration or in a policy.
 
-You can disable all providers even if they are referenced in a policy by setting `agent.providers.initial_default: false`.
+On standalone {{agent}}, you can disable all providers by setting `agent.providers.initial_default: false`, preventing them from running even if they are referenced.
 
-The following configuration disables all providers from running except for the docker provider, if it becomes referenced in the policy:
+The following configuration disables all providers with the exception of the Docker provider, which is run when it's referenced in the policy:
 
 ```yaml
 agent.providers.initial_default: false
 providers:
   docker:
     enabled: true
 ```
-
-
-
-
-
-
-
-
-
-

reference/fleet/toc.yml

@@ -102,18 +102,6 @@ toc:
           - file: elastic-agent-simplified-input-configuration.md
           - file: elastic-agent-inputs-list.md
           - file: dynamic-input-configuration.md
-      - file: providers.md
-        children:
-          - file: local-provider.md
-          - file: agent-provider.md
-          - file: host-provider.md
-          - file: env-provider.md
-          - file: filesource-provider.md
-          - file: kubernetes_secrets-provider.md
-          - file: kubernetes_leaderelection-provider.md
-          - file: local-dynamic-provider.md
-          - file: docker-provider.md
-          - file: kubernetes-provider.md
       - file: elastic-agent-output-configuration.md
         children:
           - file: elasticsearch-output.md
@@ -163,6 +151,18 @@ toc:
           - file: data-streams-advanced-features.md
       - file: alert-templates.md
   - file: agent-command-reference.md
+  - file: providers.md
+    children:
+      - file: local-provider.md
+      - file: agent-provider.md
+      - file: host-provider.md
+      - file: env-provider.md
+      - file: filesource-provider.md
+      - file: kubernetes_secrets-provider.md
+      - file: kubernetes_leaderelection-provider.md
+      - file: local-dynamic-provider.md
+      - file: docker-provider.md
+      - file: kubernetes-provider.md
   - file: agent-processors.md
     children:
       - file: processor-syntax.md