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

@@ -64,32 +64,45 @@ This section describes how to install Docker Engine on Linux, also known as Dock
   - Follow the [Ubuntu installation instructions](ubuntu.md).
   - Substitute your distribution version for the corresponding Ubuntu release.
   - Check your distribution's documentation for the matching Ubuntu release.
-- Some Linux distributions provide a Docker Engine package in their repositories. These packages are built and maintained by the distribution's maintainers and may have configuration differences or use modified source code. Docker isn't involved in releasing these packages. Report bugs or issues with these packages to your distribution's issue tracker.
+- Some Linux distributions provide a package of Docker Engine through their
+  package repositories. These packages are built and maintained by the Linux
+  distribution's package maintainers and may have differences in configuration
+  or are built from modified source code. Docker isn't involved in releasing these
+  packages and you should report any bugs or issues involving these packages to
+  your Linux distribution's issue tracker.
 
 Docker provides [binaries](binaries.md) for manual installation. These binaries are statically linked and work on any Linux distribution.
 
 ## Release channels
 
 Docker Engine has two update channels: **stable** and **test**.
 
-- The **stable** channel gives you the latest versions released for general availability.
-- The **test** channel gives you pre-release versions that are ready for testing before general availability.
+* The **stable** channel gives you the latest versions released for general availability.
+* The **test** channel gives you pre-release versions that are ready for testing before
+  general availability.
 
-Use the test channel with caution. Pre-release versions include experimental and early-access features that are subject to breaking changes.
+Use the test channel with caution. Pre-release versions include experimental and
+early-access features that are subject to breaking changes.
 
 ## Support
 
-Docker Engine is an open source project, supported by the Moby project maintainers and community members. Docker doesn't provide support for Docker Engine. Docker provides support for Docker products, including Docker Desktop, which uses Docker Engine as one of its components.
+Docker Engine is an open source project, supported by the Moby project maintainers
+and community members. Docker doesn't provide support for Docker Engine.
+Docker provides support for Docker products, including Docker Desktop, which uses
+Docker Engine as one of its components.
 
-For information about the open source project, refer to the [Moby project website](https://mobyproject.org/).
+For information about the open source project, refer to the
+[Moby project website](https://mobyproject.org/).
 
 ### Upgrade path
 
 Patch releases are always backward compatible with their major and minor version.
 
 ### Licensing
 
-Docker Engine is licensed under the Apache License, Version 2.0. See [LICENSE](https://github.com/moby/moby/blob/master/LICENSE) for the full license text.
+Docker Engine is licensed under the Apache License, Version 2.0. See
+[LICENSE](https://github.com/moby/moby/blob/master/LICENSE) for the full
+license text.
 
 ## Reporting security issues
 
@@ -101,4 +114,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 \
@@ -83,10 +81,12 @@ $ sudo dnf config-manager --add-repo {{% param "download-url-base" %}}/docker-ce
 
 #### Install Docker Engine
 
-{{< tabs >}}
-{{< tab name="Latest" >}}
+1. Install the Docker packages.
+
+   {{< tabs >}}
+   {{< tab name="Latest" >}}
 
-To install the latest version:
+   To install the latest version, run:
 
    ```console
    $ sudo dnf install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
@@ -112,19 +112,22 @@ To install the latest version:
    <...>
    ```
 
-   The list depends on which repositories are enabled and your CentOS version (see the `.el9` suffix).
+   The list returned depends on which repositories are enabled, and is specific
+   to your version of CentOS (indicated by the `.el9` suffix in this example).
 
    Install a specific version by its fully qualified package name, which is
    the package name (`docker-ce`) plus the version string (2nd column),
    separated by a hyphen (`-`). For example, `docker-ce-3:{{% param "docker_ce_version" %}}-1.el9`.
 
-   Replace `<VERSION_STRING>` with the desired version and run:
+   Replace `<VERSION_STRING>` with the desired version and then run the following
+   command to install:
 
    ```console
    $ sudo dnf install docker-ce-<VERSION_STRING> docker-ce-cli-<VERSION_STRING> containerd.io docker-buildx-plugin docker-compose-plugin
    ```
 
-   This installs Docker, but does not start it. It also creates a `docker` group, but does not add users to the group by default.
+   This command installs Docker, but it doesn't start Docker. It also creates a
+   `docker` group, however, it doesn't add any users to the group by default.
 
    {{< /tab >}}
    {{< /tabs >}}

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 \
@@ -132,7 +130,6 @@ $ sudo zypper addrepo {{% param "download-url-base" %}}/docker-ce.repo
 
    ```console
    $ sudo zypper search -s --match-exact docker-ce | sort -r
-
      v  | docker-ce | package | 3:{{% param "docker_ce_version" %}}-1 | s390x | Docker CE Stable - s390x
      v  | docker-ce | package | 3:{{% param "docker_ce_version_prev" %}}-1 | s390x | Docker CE Stable - s390x
    ```