Incorrect documentation docker volume create about moby HOT 1 OPEN

I don't think this is a bug, but the documentation may need a more complete example; https://docs.docker.com/reference/cli/docker/volume/create/

The important part here is that the name must be unique across drivers, so no 2 volumes should be allowed with the same name across multiple drivers, but for the same driver, it's treated as an idempotent action;

If you specify a volume name already in use on the current driver, Docker assumes you want to re-use the existing volume and doesn't return an error.

I once opened a ticket to suggest it should always be an error, but that ship likely sailed, and may be too late now to change that behavior;

• #16068

from moby.