Docker tag command help is confusing

[pdevine]

This is related to issue #28204 . Unfortunately I think the fix made things more confusing in certain circumstances.

If you type docker --help, the output is:

tag Create a tag TARGET_IMAGE that refers to SOURCE_IMAGE

That's technically correct, but it's confusing if you don't type docker tag --help to get the usage information:

Usage:	docker tag SOURCE_IMAGE[:TAG] TARGET_IMAGE[:TAG]

Create a tag TARGET_IMAGE that refers to SOURCE_IMAGE

This should be re-worded to something like "Use SOURCE_IMAGE to create a tag TARGET_IMAGE". Another alternative would be to just say something like "Create a new tag which refers to an existing tag" which

[thaJeztah]

Could you open this in the https://github.com/docker/cli issue tracker? That's where the code lives; if you have ideas for a better wording, perhaps a pull request? 🤗😇