diff --git a/docs/reference/compose_alpha_publish.md b/docs/reference/compose_alpha_publish.md
index 97c7357b8..056d211b0 100644
--- a/docs/reference/compose_alpha_publish.md
+++ b/docs/reference/compose_alpha_publish.md
@@ -1,7 +1,7 @@
# docker compose alpha publish
-Publish a Compose application.
+Publish compose application
### Options
diff --git a/docs/reference/compose_alpha_viz.md b/docs/reference/compose_alpha_viz.md
index 4a1763061..04bffc0b8 100644
--- a/docs/reference/compose_alpha_viz.md
+++ b/docs/reference/compose_alpha_viz.md
@@ -1,7 +1,7 @@
# docker compose alpha viz
-Generate a Graphviz graph from your compose file
+EXPERIMENTAL - Generate a graphviz graph from your compose file
### Options
@@ -12,7 +12,7 @@ Generate a Graphviz graph from your compose file
| `--indentation-size` | `int` | `1` | Number of tabs or spaces to use for indentation |
| `--networks` | | | Include service's attached networks in output graph |
| `--ports` | | | Include service's exposed ports in output graph |
-| `--spaces` | | | If given, space character ' ' is used to indent,
otherwise tab character '\t' is used |
+| `--spaces` | | | If given, space character ' ' will be used to indent,
otherwise tab character '\t' will be used |
diff --git a/docs/reference/compose_build.md b/docs/reference/compose_build.md
index f12c667b2..1eaec63e8 100644
--- a/docs/reference/compose_build.md
+++ b/docs/reference/compose_build.md
@@ -1,7 +1,7 @@
# docker compose build
-Build or rebuild services.
+Build or rebuild services
### Options
diff --git a/docs/reference/compose_config.md b/docs/reference/compose_config.md
index 9663ef817..2639cd735 100644
--- a/docs/reference/compose_config.md
+++ b/docs/reference/compose_config.md
@@ -1,7 +1,7 @@
# docker compose convert
-Parse, resolve and render Compose files in canonical format.
+Parse, resolve and render compose file in canonical format
### Aliases
diff --git a/docs/reference/compose_cp.md b/docs/reference/compose_cp.md
index f3d7b4c51..9be79443a 100644
--- a/docs/reference/compose_cp.md
+++ b/docs/reference/compose_cp.md
@@ -1,7 +1,7 @@
# docker compose cp
-Copy files or folders between a service container and the local filesystem.
+Copy files/folders between a service container and the local filesystem
### Options
diff --git a/docs/reference/compose_create.md b/docs/reference/compose_create.md
index 423279ec8..0efcc9017 100644
--- a/docs/reference/compose_create.md
+++ b/docs/reference/compose_create.md
@@ -10,10 +10,10 @@ Creates containers for a service.
| `--build` | | | Build images before starting containers. |
| `--dry-run` | | | Execute command in dry run mode |
| `--force-recreate` | | | Recreate containers even if their configuration and image haven't changed. |
-| `--no-build` | | | Don't build an image, even if it's policy |
+| `--no-build` | | | Don't build an image, even if it's policy. |
| `--no-recreate` | | | If containers already exist, don't recreate them. Incompatible with --force-recreate. |
| `--pull` | `string` | `policy` | Pull image before running ("always"\|"policy"\|"never") |
-| `--remove-orphans` | | | Remove containers for services not defined in the Compose file |
+| `--remove-orphans` | | | Remove containers for services not defined in the Compose file. |
| `--scale` | `stringArray` | | Scale SERVICE to NUM instances. Overrides the `scale` setting in the Compose file if present. |
diff --git a/docs/reference/compose_down.md b/docs/reference/compose_down.md
index 37683a901..4012b70ca 100644
--- a/docs/reference/compose_down.md
+++ b/docs/reference/compose_down.md
@@ -1,14 +1,14 @@
# docker compose down
-Stop and remove containers, networks, volumes, and images.
+Stop and remove containers, networks
### Options
| Name | Type | Default | Description |
|:-------------------|:---------|:--------|:-------------------------------------------------------------------------------------------------------------------------|
| `--dry-run` | | | Execute command in dry run mode |
-| `--remove-orphans` | | | Remove containers for services not defined in the Compose file |
+| `--remove-orphans` | | | Remove containers for services not defined in the Compose file. |
| `--rmi` | `string` | | Remove images used by services. "local" remove only images that don't have a custom tag ("local"\|"all") |
| `-t`, `--timeout` | `int` | `0` | Specify a shutdown timeout in seconds |
| `-v`, `--volumes` | | | Remove named volumes declared in the "volumes" section of the Compose file and anonymous volumes attached to containers. |
diff --git a/docs/reference/compose_exec.md b/docs/reference/compose_exec.md
index c09554837..7c5f7d6a4 100644
--- a/docs/reference/compose_exec.md
+++ b/docs/reference/compose_exec.md
@@ -7,14 +7,14 @@ Execute a command in a running container.
| Name | Type | Default | Description |
|:------------------|:--------------|:--------|:---------------------------------------------------------------------------------|
-| `-d`, `--detach` | | | Detached mode: Run command in the background |
+| `-d`, `--detach` | | | Detached mode: Run command in the background. |
| `--dry-run` | | | Execute command in dry run mode |
| `-e`, `--env` | `stringArray` | | Set environment variables |
| `--index` | `int` | `0` | index of the container if service has multiple replicas |
| `-T`, `--no-TTY` | | | Disable pseudo-TTY allocation. By default `docker compose exec` allocates a TTY. |
-| `--privileged` | | | Give extended privileges to the process |
-| `-u`, `--user` | `string` | | Run the command as this user |
-| `-w`, `--workdir` | `string` | | Path to workdir directory for this command |
+| `--privileged` | | | Give extended privileges to the process. |
+| `-u`, `--user` | `string` | | Run the command as this user. |
+| `-w`, `--workdir` | `string` | | Path to workdir directory for this command. |
diff --git a/docs/reference/compose_images.md b/docs/reference/compose_images.md
index aee6965fc..02a8f57ec 100644
--- a/docs/reference/compose_images.md
+++ b/docs/reference/compose_images.md
@@ -1,7 +1,7 @@
# docker compose images
-List images used by the created containers.
+List images used by the created containers
### Options
diff --git a/docs/reference/compose_logs.md b/docs/reference/compose_logs.md
index 0461f9581..58f56ed09 100644
--- a/docs/reference/compose_logs.md
+++ b/docs/reference/compose_logs.md
@@ -1,19 +1,19 @@
# docker compose logs
-View output from containers.
+View output from containers
### Options
| Name | Type | Default | Description |
|:---------------------|:---------|:--------|:-----------------------------------------------------------------------------------------------|
| `--dry-run` | | | Execute command in dry run mode |
-| `-f`, `--follow` | | | Follow log output |
-| `--no-color` | | | Produce monochrome output |
-| `--no-log-prefix` | | | Don't print prefix in logs |
+| `-f`, `--follow` | | | Follow log output. |
+| `--no-color` | | | Produce monochrome output. |
+| `--no-log-prefix` | | | Don't print prefix in logs. |
| `--since` | `string` | | Show logs since timestamp (e.g. 2013-01-02T13:23:37Z) or relative (e.g. 42m for 42 minutes) |
-| `-n`, `--tail` | `string` | `all` | Number of lines to show from the end of the logs for each container |
-| `-t`, `--timestamps` | | | Show timestamps |
+| `-n`, `--tail` | `string` | `all` | Number of lines to show from the end of the logs for each container. |
+| `-t`, `--timestamps` | | | Show timestamps. |
| `--until` | `string` | | Show logs before a timestamp (e.g. 2013-01-02T13:23:37Z) or relative (e.g. 42m for 42 minutes) |
diff --git a/docs/reference/compose_ls.md b/docs/reference/compose_ls.md
index 7b435564d..50a13d96f 100644
--- a/docs/reference/compose_ls.md
+++ b/docs/reference/compose_ls.md
@@ -1,7 +1,7 @@
# docker compose ls
-List running compose projects.
+List running compose projects
### Options
@@ -9,9 +9,9 @@ List running compose projects.
|:----------------|:---------|:--------|:--------------------------------------------|
| `-a`, `--all` | | | Show all stopped Compose projects |
| `--dry-run` | | | Execute command in dry run mode |
-| `--filter` | `filter` | | Filter output based on conditions provided |
+| `--filter` | `filter` | | Filter output based on conditions provided. |
| `--format` | `string` | `table` | Format the output. Values: [table \| json]. |
-| `-q`, `--quiet` | | | Only display IDs |
+| `-q`, `--quiet` | | | Only display IDs. |
diff --git a/docs/reference/compose_pause.md b/docs/reference/compose_pause.md
index a9be4ed16..334c82f18 100644
--- a/docs/reference/compose_pause.md
+++ b/docs/reference/compose_pause.md
@@ -1,7 +1,7 @@
# docker compose pause
-Pause services.
+Pause services
### Options
diff --git a/docs/reference/compose_ps.md b/docs/reference/compose_ps.md
index 4fcf5ab62..b73cae5d7 100644
--- a/docs/reference/compose_ps.md
+++ b/docs/reference/compose_ps.md
@@ -1,7 +1,7 @@
# docker compose ps
-List containers.
+List containers
### Options
diff --git a/docs/reference/compose_pull.md b/docs/reference/compose_pull.md
index 097681d12..03be4de05 100644
--- a/docs/reference/compose_pull.md
+++ b/docs/reference/compose_pull.md
@@ -1,18 +1,18 @@
# docker compose pull
-Pull service images.
+Pull service images
### Options
| Name | Type | Default | Description |
|:-------------------------|:---------|:--------|:--------------------------------------------------------|
| `--dry-run` | | | Execute command in dry run mode |
-| `--ignore-buildable` | | | Ignore images that can be built |
-| `--ignore-pull-failures` | | | Pull what it can and ignores images with pull failures |
-| `--include-deps` | | | Also pull services declared as dependencies |
-| `--policy` | `string` | | Apply pull policy ("missing"\|"always") |
-| `-q`, `--quiet` | | | Pull without printing progress information |
+| `--ignore-buildable` | | | Ignore images that can be built. |
+| `--ignore-pull-failures` | | | Pull what it can and ignores images with pull failures. |
+| `--include-deps` | | | Also pull services declared as dependencies. |
+| `--policy` | `string` | | Apply pull policy ("missing"\|"always"). |
+| `-q`, `--quiet` | | | Pull without printing progress information. |
diff --git a/docs/reference/compose_push.md b/docs/reference/compose_push.md
index 33c983458..90a4fef24 100644
--- a/docs/reference/compose_push.md
+++ b/docs/reference/compose_push.md
@@ -1,7 +1,7 @@
# docker compose push
-Push service images.
+Push service images
### Options
diff --git a/docs/reference/compose_restart.md b/docs/reference/compose_restart.md
index 2568d871e..1e7bdf3c8 100644
--- a/docs/reference/compose_restart.md
+++ b/docs/reference/compose_restart.md
@@ -1,14 +1,14 @@
# docker compose restart
-Restart service containers.
+Restart service containers
### Options
| Name | Type | Default | Description |
|:------------------|:------|:--------|:--------------------------------------|
| `--dry-run` | | | Execute command in dry run mode |
-| `--no-deps` | | | Don't restart dependent services |
+| `--no-deps` | | | Don't restart dependent services. |
| `-t`, `--timeout` | `int` | `0` | Specify a shutdown timeout in seconds |
diff --git a/docs/reference/compose_rm.md b/docs/reference/compose_rm.md
index 7179f320d..cbd8e50f6 100644
--- a/docs/reference/compose_rm.md
+++ b/docs/reference/compose_rm.md
@@ -1,7 +1,7 @@
# docker compose rm
-Removes stopped service containers.
+Removes stopped service containers
By default, anonymous volumes attached to containers will not be removed. You
can override this with -v. To list all volumes, use "docker volume ls".
diff --git a/docs/reference/compose_run.md b/docs/reference/compose_run.md
index 62c662264..3eea660e5 100644
--- a/docs/reference/compose_run.md
+++ b/docs/reference/compose_run.md
@@ -7,23 +7,23 @@ Run a one-off command on a service.
| Name | Type | Default | Description |
|:----------------------|:--------------|:--------|:----------------------------------------------------------------------------------|
-| `--build` | | | Build image before starting container |
+| `--build` | | | Build image before starting container. |
| `--cap-add` | `list` | | Add Linux capabilities |
| `--cap-drop` | `list` | | Drop Linux capabilities |
| `-d`, `--detach` | | | Run container in background and print container ID |
| `--dry-run` | | | Execute command in dry run mode |
| `--entrypoint` | `string` | | Override the entrypoint of the image |
| `-e`, `--env` | `stringArray` | | Set environment variables |
-| `-i`, `--interactive` | | | Keep STDIN open even if not attached |
+| `-i`, `--interactive` | | | Keep STDIN open even if not attached. |
| `-l`, `--label` | `stringArray` | | Add or override a label |
| `--name` | `string` | | Assign a name to the container |
| `-T`, `--no-TTY` | | | Disable pseudo-TTY allocation (default: auto-detected). |
-| `--no-deps` | | | Don't start linked services |
-| `-p`, `--publish` | `stringArray` | | Publish a container's port(s) to the host |
-| `--quiet-pull` | | | Pull without printing progress information |
-| `--remove-orphans` | | | Remove containers for services not defined in the Compose file |
+| `--no-deps` | | | Don't start linked services. |
+| `-p`, `--publish` | `stringArray` | | Publish a container's port(s) to the host. |
+| `--quiet-pull` | | | Pull without printing progress information. |
+| `--remove-orphans` | | | Remove containers for services not defined in the Compose file. |
| `--rm` | | | Automatically remove the container when it exits |
-| `--service-ports` | | | Run command with the service's ports enabled and mapped to the host |
+| `--service-ports` | | | Run command with the service's ports enabled and mapped to the host. |
| `--use-aliases` | | | Use the service's network useAliases in the network(s) the container connects to. |
| `-u`, `--user` | `string` | | Run as specified username or uid |
| `-v`, `--volume` | `stringArray` | | Bind mount a volume. |
diff --git a/docs/reference/compose_scale.md b/docs/reference/compose_scale.md
index e6185d436..5cf5830e2 100644
--- a/docs/reference/compose_scale.md
+++ b/docs/reference/compose_scale.md
@@ -1,14 +1,14 @@
# docker compose scale
-Scale services.
+Scale services
### Options
| Name | Type | Default | Description |
|:------------|:-----|:--------|:--------------------------------|
| `--dry-run` | | | Execute command in dry run mode |
-| `--no-deps` | | | Don't start linked services |
+| `--no-deps` | | | Don't start linked services. |
diff --git a/docs/reference/compose_start.md b/docs/reference/compose_start.md
index b8f424cfd..b525347f7 100644
--- a/docs/reference/compose_start.md
+++ b/docs/reference/compose_start.md
@@ -1,7 +1,7 @@
# docker compose start
-Start services.
+Start services
### Options
diff --git a/docs/reference/compose_stop.md b/docs/reference/compose_stop.md
index 71441f24b..e7cf92a80 100644
--- a/docs/reference/compose_stop.md
+++ b/docs/reference/compose_stop.md
@@ -1,7 +1,7 @@
# docker compose stop
-Stop services.
+Stop services
### Options
diff --git a/docs/reference/compose_top.md b/docs/reference/compose_top.md
index 5d12a0f83..9aff0ce71 100644
--- a/docs/reference/compose_top.md
+++ b/docs/reference/compose_top.md
@@ -1,7 +1,7 @@
# docker compose top
-Display the running processes.
+Display the running processes
### Options
diff --git a/docs/reference/compose_unpause.md b/docs/reference/compose_unpause.md
index 923eb2ead..0df10a992 100644
--- a/docs/reference/compose_unpause.md
+++ b/docs/reference/compose_unpause.md
@@ -1,7 +1,7 @@
# docker compose unpause
-Unpause services.
+Unpause services
### Options
diff --git a/docs/reference/compose_up.md b/docs/reference/compose_up.md
index f634cb7d0..8f7428e05 100644
--- a/docs/reference/compose_up.md
+++ b/docs/reference/compose_up.md
@@ -1,7 +1,7 @@
# docker compose up
-Create and start containers.
+Create and start containers
### Options
@@ -10,28 +10,28 @@ Create and start containers.
| `--abort-on-container-exit` | | | Stops all containers if any container was stopped. Incompatible with -d |
| `--always-recreate-deps` | | | Recreate dependent containers. Incompatible with --no-recreate. |
| `--attach` | `stringArray` | | Restrict attaching to the specified services. Incompatible with --attach-dependencies. |
-| `--attach-dependencies` | | | Automatically attach to log output of dependent services |
-| `--build` | | | Build images before starting containers |
+| `--attach-dependencies` | | | Automatically attach to log output of dependent services. |
+| `--build` | | | Build images before starting containers. |
| `-d`, `--detach` | | | Detached mode: Run containers in the background |
| `--dry-run` | | | Execute command in dry run mode |
-| `--exit-code-from` | `string` | | Return the exit code of the selected service container. Implies --abort-on-container-exit. |
-| `--force-recreate` | | | Recreate containers even if their configuration and image haven't changed |
-| `--no-attach` | `stringArray` | | Do not attach (stream logs) to the specified services |
-| `--no-build` | | | Don't build an image, even if it's policy |
+| `--exit-code-from` | `string` | | Return the exit code of the selected service container. Implies --abort-on-container-exit |
+| `--force-recreate` | | | Recreate containers even if their configuration and image haven't changed. |
+| `--no-attach` | `stringArray` | | Do not attach (stream logs) to the specified services. |
+| `--no-build` | | | Don't build an image, even if it's policy. |
| `--no-color` | | | Produce monochrome output. |
-| `--no-deps` | | | Don't start linked services |
+| `--no-deps` | | | Don't start linked services. |
| `--no-log-prefix` | | | Don't print prefix in logs. |
| `--no-recreate` | | | If containers already exist, don't recreate them. Incompatible with --force-recreate. |
-| `--no-start` | | | Don't start the services after creating them |
+| `--no-start` | | | Don't start the services after creating them. |
| `--pull` | `string` | `policy` | Pull image before running ("always"\|"policy"\|"never") |
-| `--quiet-pull` | | | Pull without printing progress information |
-| `--remove-orphans` | | | Remove containers for services not defined in the Compose file |
-| `-V`, `--renew-anon-volumes` | | | Recreate anonymous volumes instead of retrieving data from the previous containers |
+| `--quiet-pull` | | | Pull without printing progress information. |
+| `--remove-orphans` | | | Remove containers for services not defined in the Compose file. |
+| `-V`, `--renew-anon-volumes` | | | Recreate anonymous volumes instead of retrieving data from the previous containers. |
| `--scale` | `stringArray` | | Scale SERVICE to NUM instances. Overrides the `scale` setting in the Compose file if present. |
-| `-t`, `--timeout` | `int` | `0` | Use this timeout in seconds for container shutdown when attached or when containers are already running |
-| `--timestamps` | | | Show timestamps |
+| `-t`, `--timeout` | `int` | `0` | Use this timeout in seconds for container shutdown when attached or when containers are already running. |
+| `--timestamps` | | | Show timestamps. |
| `--wait` | | | Wait for services to be running\|healthy. Implies detached mode. |
-| `--wait-timeout` | `int` | `0` | Maximum duration to wait for the project to be running\|healthy |
+| `--wait-timeout` | `int` | `0` | Maximum duration to wait for the project to be running\|healthy. |
diff --git a/docs/reference/compose_version.md b/docs/reference/compose_version.md
index c3be03c4e..66081d65e 100644
--- a/docs/reference/compose_version.md
+++ b/docs/reference/compose_version.md
@@ -1,7 +1,7 @@
# docker compose version
-Show the Docker Compose version information.
+Show the Docker Compose version information
### Options
@@ -9,7 +9,7 @@ Show the Docker Compose version information.
|:-----------------|:---------|:--------|:---------------------------------------------------------------|
| `--dry-run` | | | Execute command in dry run mode |
| `-f`, `--format` | `string` | | Format the output. Values: [pretty \| json]. (Default: pretty) |
-| `--short` | | | Shows only Compose's version number.|
+| `--short` | | | Shows only Compose's version number. |
diff --git a/docs/reference/compose_wait.md b/docs/reference/compose_wait.md
index 59f2f2681..9c9ff6f1c 100644
--- a/docs/reference/compose_wait.md
+++ b/docs/reference/compose_wait.md
@@ -1,7 +1,7 @@
# docker compose wait
-Block until the first service container stops.
+Block until the first service container stops
### Options
diff --git a/docs/reference/compose_watch.md b/docs/reference/compose_watch.md
index 8874e2744..068704618 100644
--- a/docs/reference/compose_watch.md
+++ b/docs/reference/compose_watch.md
@@ -1,7 +1,7 @@
# docker compose watch
-Watch build context for service and rebuild or refresh containers when files are updated.
+Watch build context for service and rebuild/refresh containers when files are updated
### Options
@@ -9,7 +9,7 @@ Watch build context for service and rebuild or refresh containers when files are
|:------------|:-----|:--------|:----------------------------------------------|
| `--dry-run` | | | Execute command in dry run mode |
| `--no-up` | | | Do not build & start services before watching |
-| `--quiet` | | | Hide build output |
+| `--quiet` | | | hide build output |
diff --git a/docs/reference/docker_compose.yaml b/docs/reference/docker_compose.yaml
index b6f5d76c5..c096f8923 100644
--- a/docs/reference/docker_compose.yaml
+++ b/docs/reference/docker_compose.yaml
@@ -1,7 +1,7 @@
command: docker compose
short: Docker Compose
long: |-
- You can use compose subcommand, `docker compose [-f ...] [options] [COMMAND] [ARGS...]`, to build and manage
+ You can use the compose subcommand, `docker compose [-f ...] [options] [COMMAND] [ARGS...]`, to build and manage
multiple services in Docker containers.
### Use `-f` to specify the name and path of one or more Compose files
@@ -90,16 +90,16 @@ long: |-
### Use profiles to enable optional services
Use `--profile` to specify one or more active profiles
- Calling `docker compose --profile frontend up` will start the services with the profile `frontend` and services
+ Calling `docker compose --profile frontend up` starts the services with the profile `frontend` and services
without any specified profiles.
- You can also enable multiple profiles, e.g. with `docker compose --profile frontend --profile debug up` the profiles `frontend` and `debug` will be enabled.
+ You can also enable multiple profiles, e.g. with `docker compose --profile frontend --profile debug up` the profiles `frontend` and `debug` is enabled.
Profiles can also be set by `COMPOSE_PROFILES` environment variable.
### Configuring parallelism
Use `--parallel` to specify the maximum level of parallelism for concurrent engine calls.
- Calling `docker compose --parallel 1 pull` will pull the pullable images defined in the Compose file
+ Calling `docker compose --parallel 1 pull` pulls the pullable images defined in the Compose file
one at a time. This can also be used to control build concurrency.
Parallelism can also be set by the `COMPOSE_PARALLEL_LIMIT` environment variable.
@@ -115,7 +115,7 @@ long: |-
If flags are explicitly set on the command line, the associated environment variable is ignored.
- Setting the `COMPOSE_IGNORE_ORPHANS` environment variable to `true` will stop docker compose from detecting orphaned
+ Setting the `COMPOSE_IGNORE_ORPHANS` environment variable to `true` stops docker compose from detecting orphaned
containers for the project.
### Use Dry Run mode to test your command
diff --git a/docs/reference/docker_compose_config.yaml b/docs/reference/docker_compose_config.yaml
index d19a786c6..d180c8d14 100644
--- a/docs/reference/docker_compose_config.yaml
+++ b/docs/reference/docker_compose_config.yaml
@@ -2,8 +2,8 @@ command: docker compose config
aliases: docker compose config, docker compose convert
short: Parse, resolve and render compose file in canonical format
long: |-
- `docker compose config` renders the actual data model to be applied on the Docker engine.
- it merges the Compose files set by `-f` flags, resolves variables in the Compose file, and expands short-notation into
+ `docker compose config` renders the actual data model to be applied on the Docker Engine.
+ It merges the Compose files set by `-f` flags, resolves variables in the Compose file, and expands short-notation into
the canonical format.
usage: docker compose config [OPTIONS] [SERVICE...]
pname: docker compose
diff --git a/docs/reference/docker_compose_down.yaml b/docs/reference/docker_compose_down.yaml
index 8d6388129..7964dd49c 100644
--- a/docs/reference/docker_compose_down.yaml
+++ b/docs/reference/docker_compose_down.yaml
@@ -5,13 +5,13 @@ long: |-
By default, the only things removed are:
- - Containers for services defined in the Compose file
- - Networks defined in the networks section of the Compose file
- - The default network, if one is used
+ - Containers for services defined in the Compose file.
+ - Networks defined in the networks section of the Compose file.
+ - The default network, if one is used.
Networks and volumes defined as external are never removed.
- Anonymous volumes are not removed by default. However, as they don’t have a stable name, they will not be automatically
+ Anonymous volumes are not removed by default. However, as they don’t have a stable name, they are not automatically
mounted by a subsequent `up`. For data that needs to persist between updates, use explicit paths as bind mounts or
named volumes.
usage: docker compose down [OPTIONS] [SERVICES]
diff --git a/docs/reference/docker_compose_ps.yaml b/docs/reference/docker_compose_ps.yaml
index 7525fcdb0..9e6bb072e 100644
--- a/docs/reference/docker_compose_ps.yaml
+++ b/docs/reference/docker_compose_ps.yaml
@@ -9,7 +9,7 @@ long: |-
example-foo-1 alpine "/entrypoint.…" foo 4 seconds ago Up 2 seconds 0.0.0.0:8080->80/tcp
```
- By default, only running containers are shown. `--all` flag can be used to include stopped containers
+ By default, only running containers are shown. `--all` flag can be used to include stopped containers.
```console
$ docker compose ps --all
@@ -128,7 +128,7 @@ examples: |-
```
The JSON output allows you to use the information in other tools for further
- processing, for example, using the [`jq` utility](https://stedolan.github.io/jq/){:target="_blank" rel="noopener" class="_"}
+ processing, for example, using the [`jq` utility](https://stedolan.github.io/jq/)
to pretty-print the JSON:
```console
diff --git a/docs/reference/docker_compose_pull.yaml b/docs/reference/docker_compose_pull.yaml
index 5d2886afa..46a471162 100644
--- a/docs/reference/docker_compose_pull.yaml
+++ b/docs/reference/docker_compose_pull.yaml
@@ -89,7 +89,7 @@ inherited_options:
kubernetes: false
swarm: false
examples: |-
- suppose you have this `compose.yaml`:
+ Consider the following `compose.yaml`:
```yaml
services:
@@ -130,8 +130,7 @@ examples: |-
⠹ c8752d5b785c Waiting 9.3s
```
- `docker compose pull` will try to pull image for services with a build section. If pull fails, it will let
- user know this service image MUST be built. You can skip this by setting `--ignore-buildable` flag
+ `docker compose pull` tries to pull image for services with a build section. If pull fails, it lets you know this service image must be built. You can skip this by setting `--ignore-buildable` flag.
deprecated: false
hidden: false
experimental: false
diff --git a/docs/reference/docker_compose_restart.yaml b/docs/reference/docker_compose_restart.yaml
index bc907aacc..3126eb005 100644
--- a/docs/reference/docker_compose_restart.yaml
+++ b/docs/reference/docker_compose_restart.yaml
@@ -8,7 +8,7 @@ long: |-
after a container is built, but before the container's command is executed) are not updated
after restarting.
- If you are looking to configure a service's restart policy, please refer to
+ If you are looking to configure a service's restart policy, refer to
[restart](https://github.com/compose-spec/compose-spec/blob/master/spec.md#restart)
or [restart_policy](https://github.com/compose-spec/compose-spec/blob/master/deploy.md#restart_policy).
usage: docker compose restart [OPTIONS] [SERVICE...]