Skip to content

Commit f2c4792

Browse files
authored
Reword the Official Images description (docker-library#9379)
* Update README.md
1 parent a70d60a commit f2c4792

File tree

1 file changed

+12
-6
lines changed

1 file changed

+12
-6
lines changed

README.md

Lines changed: 12 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -37,17 +37,23 @@
3737

3838
## What are "Official Images"?
3939

40-
See [Docker's documentation](https://docs.docker.com/docker-hub/official_repos/) for a good high-level overview of the program.
40+
The Docker Official Images are curated images [hosted on Docker Hub](https://hub.docker.com/u/library). The main tenets are:
41+
42+
- Focus on [Free](https://www.fsf.org/) and [Open-Source](https://opensource.org/) Software
43+
44+
- Support [multiple architectures](#architectures-other-than-amd64)
4145

42-
## What do you mean by "Official"?
46+
- Exemplify [`Dockerfile` best practices](https://docs.docker.com/develop/develop-images/dockerfile_best-practices/)
4347

44-
In many cases, the images in this program are not only supported but also *maintained* directly by the relevant upstream projects.
48+
- [Actively rebuild](#library-definition-files) for updates and security fixes
4549

46-
For some, they're developed in collaboration with the upstream project (or with the explicit blessing of the upstream project).
50+
- Adhere to upstream recommendations
4751

48-
In all cases, we strive to create images that are true to the upstream project's vision for how their project is intended to be consumed, occasionally adding additional behavior to make them more friendly to use within Docker / containerization in general.
52+
- Add minimal quality-of-life behavior for the container environment where fit
53+
54+
See [Docker's documentation](https://docs.docker.com/docker-hub/official_repos/) for a good high-level overview of the program.
4955

50-
The name of this program was chosen in an attempt to reflect that upstream-first focus (although in hindsight, it's clear that it was a choice with some amount of confusion potential for which we're sorry).
56+
In essence we strive to heed upstream's recommendations on how they intend for their software to be consumed. Many images are maintained in collaboration with the relevant upstream project if not maintained directly by them. Additionally we aim to exemplify the best practices for Dockerfiles to serve as a reference when making or deriving your own images from them.
5157

5258
(If you are a representative of an upstream for which there exists an image and you would like to get involved, please see the [Maintainership](#maintainership) section below!)
5359

0 commit comments

Comments
 (0)