1diff --git a/plugins/docker-compose/README.md b/plugins/docker-compose/README.md
2index 66d4e0521623869b473a25a6535bcd2a5ebe9589..5a0290462474c5e51a8aaae49634fa5133da02de 100644
3--- a/plugins/docker-compose/README.md
4+++ b/plugins/docker-compose/README.md
5@@ -2,6 +2,8 @@
6 7 This plugin provides completion for [docker-compose](https://docs.docker.com/compose/) as well as some
8 aliases for frequent docker-compose commands.
9+This plugin chooses automatically between the legacy `docker-compose` command and the modern
10+`docker compose` subcommand, preferring `docker-compose` when both are available.
1112 To use it, add docker-compose to the plugins array of your zshrc file:
13