Skip to content

Conversation

@yosifkit
Copy link
Member

This also adds a section about docker-library/docker#559

Refs:


The `%%IMAGE%%` images come in many flavors, each designed for a specific use case.

**Note:**: The `*stable`, and `*test` tags have been deprecated since June 2020 (see [docker-library/docker#179](https://github.com/docker-library/docker/pull/179)) and were no longer updated in December 2020 when Docker 20.10 was released. The alternative to `stable` is to use `latest` (there was no difference when it was deprecated). You can also use the `cli`, and `dind` tags to get the latest Docker CLI or engine, respectively. The alternative to the `test` tags is to use the `rc` tag or a tag with `-rc` in it. The `rc` tag is only updated when there is an active pre-release and will not point to the same thing as `latest`.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Some very minor rewording / reorganization for your consideration (trying to make the "what's the action?" more obvious):

Suggested change
**Note:**: The `*stable`, and `*test` tags have been deprecated since June 2020 (see [docker-library/docker#179](https://github.com/docker-library/docker/pull/179)) and were no longer updated in December 2020 when Docker 20.10 was released. The alternative to `stable` is to use `latest` (there was no difference when it was deprecated). You can also use the `cli`, and `dind` tags to get the latest Docker CLI or engine, respectively. The alternative to the `test` tags is to use the `rc` tag or a tag with `-rc` in it. The `rc` tag is only updated when there is an active pre-release and will not point to the same thing as `latest`.
**Note:** The `docker:stable`, `docker:test`, and related "channel" tags have been deprecated since June 2020 (see [docker-library/docker#179](https://github.com/docker-library/docker/pull/179)) and have not been updated since December 2020 (when Docker 20.10 was released). Suggested alternatives:
- `docker:stable``docker:latest` (aliases to the same image at the time of deprecation), `docker:X.Y`, etc
- `docker:test``docker:rc`, `docker:X.Y-rc`, `docker:rc-cli`, etc (only updated when there is an active pre-release; will not point to the same thing as `latest`)

@tianon tianon merged commit 1e8f812 into docker-library:master Nov 22, 2025
6 checks passed
@tianon tianon deleted the dind branch November 22, 2025 00:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants