Apply suggestions from code review

Co-authored-by: Edu González de la Herrán <[email protected]>

Author: shainaraskas

deploy-manage/deploy/self-managed.md

@@ -15,7 +15,7 @@ If you want to install Elastic on your own premises without the assistance of an
 To quickly set up {{es}} and {{kib}} in Docker for local development or testing, jump to [](/deploy-manage/deploy/self-managed/local-development-installation-quickstart.md).
 
 :::{admonition} Simplify the deployment process
-Self-managed clusters are useful for local development, and for exploring Elastic features. However, Elastic offer several deployment options that can simplify the process of deploying and managing multi-node deployments, especially in production. They also allow you to deploy and manage multiple deployments from a single surface.
+Self-managed clusters are useful for local development, and for exploring Elastic features. However, Elastic offers several deployment options that can simplify the process of deploying and managing multi-node deployments, especially in production. They also allow you to deploy and manage multiple deployments from a single surface.
 
 Managed by Elastic: 
 * [{{serverless-full}}](/deploy-manage/deploy/elastic-cloud/serverless.md)
@@ -54,7 +54,7 @@ Learn how to install and configure {{es}}. {{es}} is the distributed search and
 
 ### Deploying Kibana
 
-After you deploy {{es}}, you can install {{kib}}. {{kib}} provides the user interface for all Elastic solutions. It’s a powerful tool for visualizing and analyzing your data, and for managing and monitoring the {{stack}}. Although {{kib}} is not required to use {{es}}, it's required for most use cases.
+After you deploy {{es}}, you can install {{kib}}. {{kib}} provides the user interface for all Elastic solutions. It’s a powerful tool for [visualizing and analyzing](/explore-analyze/index.md) your data, and for managing and monitoring the {{stack}}. Although {{kib}} is not required to use {{es}}, it's required for most [use cases](/solutions/index.md).
 
 * [](/deploy-manage/deploy/self-managed/install-kibana.md): Install {{kib}} using one of our install packages or container images, and enroll {{kib}} with your {{es}} cluster.
 * [](/deploy-manage/deploy/self-managed/configure-kibana.md): Learn how to make configuration changes to {{kib}}.
@@ -81,7 +81,7 @@ Review these other sections for critical information about securing and managing
 Learn how to secure your Elastic environment to restrict access to only authorized parties, and allow communication between your environment and external parties.
 
 * [](/deploy-manage/security.md): Learn about security features that prevent bad actors from tampering with your data, and encrypt communications to, from, and within your cluster.
-* [](/deploy-manage/users-roles/cluster-or-deployment-auth.md): Set up authentication and authorization for your cluster, and learn about the underlying security technologies that {{es}} uses to authenticate and authorize requests internally and across services.
+* [Users and roles](/deploy-manage/users-roles/cluster-or-deployment-auth.md): Set up authentication and authorization for your cluster, and learn about the underlying security technologies that {{es}} uses to authenticate and authorize requests internally and across services.
 * [](/deploy-manage/manage-spaces.md): Learn how to organize content in {{kib}}, and restrict access to this content to specific users.
 * [](/deploy-manage/api-keys.md): Authenticate and authorize programmatic access to your deployments and {{es}} resources.
 * [](/deploy-manage/manage-connectors.md): Manage connection information between Elastic and third-party systems.

deploy-manage/deploy/self-managed/_snippets/cmd-line-config.md

@@ -1,8 +1,7 @@
 {{es}} loads its configuration from the following location by default:
 
-```
+```sh subs=true
 {{es-conf}}{{slash}}elasticsearch.yml
-```
 
 The format of this config file is explained in [](/deploy-manage/deploy/self-managed/configure-elasticsearch.md).
 

deploy-manage/deploy/self-managed/air-gapped-install.md

@@ -40,12 +40,12 @@ Specifically:
 
 ## {{beats}} [air-gapped-beats]
 
-Elastic {{beats}} are light-weight data shippers. They do not require any unique setup in the air-gapped scenario. To learn more, refer to the [{{beats}} documentation](asciidocalypse://docs/beats/docs/reference/index.md).
+Elastic {{beats}} are light-weight data shippers. They do not require any special configuration in air-gapped environments. To learn more, refer to the [{{beats}} documentation](asciidocalypse://docs/beats/docs/reference/index.md).
 
 
 ## {{ls}} [air-gapped-logstash]
 
-{{ls}} is a versatile data shipping and processing application. It does not require any unique setup in the air-gapped scenario. To learn more, refer to the [{{ls}} documentation](asciidocalypse://docs/logstash/docs/reference/index.md).
+{{ls}} is a versatile data shipping and processing application. It does not require any special configuration in air-gapped environments. To learn more, refer to the [{{ls}} documentation](asciidocalypse://docs/logstash/docs/reference/index.md).
 
 
 ## {{agent}} [air-gapped-elastic-agent]

deploy-manage/deploy/self-managed/install-elasticsearch-docker-prod.md

@@ -186,9 +186,9 @@ docker.elastic.co/elasticsearch/elasticsearch:{{stack-version}}
 
 ## Always bind data volumes [_always_bind_data_volumes]
 
-You should use a volume bound on `/usr/share/elasticsearch/data` for the following reasons:
+You should use a volume bound to `/usr/share/elasticsearch/data` for the following reasons:
 
-1. The data of your {{es}} node won’t be lost if the container is killed.
+1. The data of your {{es}} node won’t be lost if the container is deleted.
 2. {{es}} is I/O sensitive and the Docker storage driver is not ideal for fast I/O.
 3. It allows the use of advanced [Docker volume plugins](https://docs.docker.com/engine/extend/plugins/#volume-plugins).