docs/deprecated: update status of short cid alias deprecation

[akerouanton]

• Related to libnet: Endpoint: remove isAnonymous & myAliases moby/moby#46853

- What I did

Starting with API v1.45, the container short ID is removed from the container Aliases. Update the status for that deprecation.

[codecov-commenter]

Codecov Report

Merging #4949 (f96d8e7) into master (38fcd1c) will not change coverage.
The diff coverage is n/a.

Additional details and impacted files

@@           Coverage Diff           @@
##           master    #4949   +/-   ##
=======================================
  Coverage   61.43%   61.43%           
=======================================
  Files         289      289           
  Lines       20241    20241           
=======================================
  Hits        12435    12435           
  Misses       6904     6904           
  Partials      902      902           

[robmry]

LGTM

[thaJeztah]

Do we need to mention that it's deprecated for API XX, but older API versions still having it?

[akerouanton]

Do we need to mention that it's deprecated for API XX, but older API versions still having it?

Is that something we usually do in docs/deprecated.md? Except for "Deprecate legacy API versions", it seems we never advertise the use of DOCKER_API_VERSION.

[thaJeztah]

It's a bit similar to #4893 (comment) - we don't recommend DOCKER_API_VERSION, but clients that were created for an older version of the API should continue to observe the old behavior (i.e., older API versions are not "touched").

We should probably look (as discussed in the other PR) to more prominently add a link to the API history, as that's effectively the source of truth for API changes (including deprecations)

[akerouanton]

It's a bit similar to #4893 (comment) - we don't recommend DOCKER_API_VERSION, but clients that were created for an older version of the API should continue to observe the old behavior (i.e., older API versions are not "touched").

Then, should we mention that only newer CLI versions are affected, ie. CLI v26 and above?

[neersighted]

Glancing at previous deprecations, this should be sufficient on the CLI side.

The 1.45 deprecation does not mention the change telegraphed in 1.44:

https://github.com/moby/moby/blob/963e1f3eed52024629557c11503c56f28d578f55/docs/api/version-history.md?plain=1#L16-L27

https://github.com/moby/moby/blob/963e1f3eed52024629557c11503c56f28d578f55/docs/api/version-history.md?plain=1#L86-L90

I think all we need to do is make sure to add the change to API 1.45; with that change, this LGTM.