tweaks

Author: ArthurFlag

content/manuals/engine/_index.md

@@ -51,11 +51,16 @@ aliases:
 - /linux/
 ---
 
-Docker Engine is an open source containerization technology for building and containerizing your applications. Docker Engine acts as a client-server application with:
+Docker Engine is an open source containerization technology for building and
+containerizing your applications. Docker Engine acts as a client-server
+application with:
 
-- A server with a long-running daemon process [`dockerd`](/reference/cli/dockerd)
-- APIs that specify interfaces that programs can use to talk to and instruct the Docker daemon
-- A command line interface (CLI) client [`docker`](/reference/cli/docker/)
+- A server with a long-running daemon process
+  [`dockerd`](/reference/cli/dockerd).
+- APIs which specify interfaces that programs can use to talk to and instruct
+  the Docker daemon.
+- A command line interface (CLI) client
+  [`docker`](/reference/cli/docker/).
 
 The CLI uses [Docker APIs](/reference/api/engine/_index.md) to control or interact with the Docker
 daemon through scripting or direct CLI commands. Many other Docker applications

content/manuals/engine/install/_index.md

@@ -101,4 +101,5 @@ Docker appreciates security reports and will publicly thank you for your contrib
 
 ## Get started
 
-After setting up Docker, you can learn the basics with [Getting started with Docker](/get-started/introduction/_index.md).
+After setting up Docker, you can learn the basics with
+[Getting started with Docker](/get-started/introduction/_index.md).

content/manuals/engine/install/centos.md

@@ -37,11 +37,9 @@ CentOS versions:
 
 ### Uninstall old versions
 
-Before you install Docker Engine, uninstall any conflicting packages.
-
-Your Linux distribution may provide unofficial Docker packages, which can
-conflict with the official packages provided by Docker. Uninstall these packages
-before installing the official version.
+Uninstall unofficial or conflicting Docker packages provided
+by your Linux distribution before installing Docker Engine.
+Remove the following packages if present:
 
 ```console
 $ sudo dnf remove docker \

content/manuals/engine/install/debian.md

@@ -22,12 +22,17 @@ To get started with Docker Engine on Debian, make sure you
 
 ### Firewall limitations
 
-When exposing container ports with Docker, these ports bypass `ufw` or `firewalld` rules.
-See [Docker and ufw](/manuals/engine/network/packet-filtering-firewalls.md#docker-and-ufw) for details.
-Docker supports only `iptables-nft` and `iptables-legacy`.
-Rules created with `nft` are not supported on a system with Docker installed.
-Use `iptables` or `ip6tables` and add rules to the `DOCKER-USER` chain.
-See [Packet filtering and firewalls](/manuals/engine/network/packet-filtering-firewalls.md).
+> [!WARNING]
+>
+> Before you install Docker, make sure you consider the following
+> security implications and firewall incompatibilities.
+
+- When exposing container ports with Docker, these ports bypass `ufw` or `firewalld` rules.
+  See [Docker and ufw](/manuals/engine/network/packet-filtering-firewalls.md#docker-and-ufw) for details.
+- Docker supports only `iptables-nft` and `iptables-legacy`.
+  Rules created with `nft` are not supported on a system with Docker installed.
+  Use `iptables` or `ip6tables` and add rules to the `DOCKER-USER` chain.
+  See [Packet filtering and firewalls](/manuals/engine/network/packet-filtering-firewalls.md).
 
 ### OS requirements
 
@@ -42,7 +47,8 @@ and ppc64le (ppc64el) architectures.
 
 ### Uninstall old versions
 
-Uninstall unofficial or conflicting Docker packages before installing Docker Engine.
+Uninstall unofficial or conflicting Docker packages provided
+by your Linux distribution before installing Docker Engine.
 Remove the following packages if present:
 
 - `docker.io`

content/manuals/engine/install/fedora.md

@@ -31,7 +31,8 @@ Docker Engine requires a maintained version of Fedora:
 
 ### Uninstall old versions
 
-Uninstall unofficial or conflicting Docker packages before installing Docker Engine.
+Uninstall unofficial or conflicting Docker packages provided
+by your Linux distribution before installing Docker Engine.
 Remove the following packages if present:
 
 ```console

content/manuals/engine/install/raspberry-pi-os.md

@@ -51,11 +51,9 @@ To install Docker Engine, you need one of the following OS versions:
 
 ### Uninstall old versions
 
-Before you can install Docker Engine, you need to uninstall any conflicting packages.
-
-Your Linux distribution may provide unofficial Docker packages, which may conflict
-with the official packages provided by Docker. You must uninstall these packages
-before you install the official version of Docker Engine.
+Uninstall unofficial or conflicting Docker packages provided
+by your Linux distribution before installing Docker Engine.
+Remove the following packages if present:
 
 The unofficial packages to uninstall are:
 
@@ -132,7 +130,7 @@ Docker from the repository.
    ```console
    $ sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
    ```
-  
+
    {{< /tab >}}
    {{< tab name="Specific version" >}}
 

content/manuals/engine/install/rhel.md

@@ -34,11 +34,9 @@ Docker Engine requires a maintained version of RHEL:
 
 ### Uninstall old versions
 
-Before you can install Docker Engine, you need to uninstall any conflicting packages.
-
-Your Linux distribution may provide unofficial Docker packages, which may conflict
-with the official packages provided by Docker. You must uninstall these packages
-before you install the official version of Docker Engine.
+Uninstall unofficial or conflicting Docker packages provided
+by your Linux distribution before installing Docker Engine.
+Remove the following packages if present:
 
 ```console
 $ sudo dnf remove docker \

content/manuals/engine/install/sles.md

@@ -51,11 +51,9 @@ $ sudo zypper addrepo $opensuse_repo
 
 ### Uninstall old versions
 
-Uninstall any conflicting packages before you install Docker Engine.
-
-Your Linux distribution may provide unofficial Docker packages, which may conflict
-with the official packages provided by Docker. You must uninstall these packages
-before you install the official version of Docker Engine.
+Uninstall unofficial or conflicting Docker packages provided
+by your Linux distribution before installing Docker Engine.
+Remove the following packages if present:
 
 ```console
 $ sudo zypper remove docker \