Expand our "repo-info" blurb to link to both the "local" and "remote" directories (and explain a little bit about what each is)

[tianon]

No description provided.

[tianon]

Example blurb:

For detailed information about each of the above supported tags, please see the repos/alpine/remote directory (gathered from the Docker Hub API; transfer sizes, layer details, etc) and the repos/alpine/local directory (gathered from the image after it is pulled; installed packages, etc) in the docker-library/repo-info GitHub repo.

[yosifkit]

Those are some really long links. So my initial thought for improving clarity was something like this:

For detailed information about each of the above supported tags, please see the following from the docker-library/repo-info GitHub repo:

• repos/%%REPO%%/remote directory
  • gathered from the Docker Hub API
  • transfer sizes, layer details, etc
• repos/%%REPO%%/local directory
  • gathered from the image after it is pulled
  • installed packages, creation date, architecture, environment variables, etc

But then we discussed where it goes on the hub page and it makes more sense to minimize this part to just a sentence and then link to repo-info/%%REPO%%/ and have a Readme file there that describes what is in each folder. This other readme can then grow and improve as the data in repo-info changes and improves.

[tianon]

A bit long in the works, but here's my proposal for the structure of that repos/%%REPO%%/README.md file:

alpine repo-info

This directory contains additional information about the published artifacts of the alpine official image.

• the remote directory:

  • gathered from the Docker Hub/Registry API

  • image digests/blobs, transfer sizes, image metadata, etc.

• the local directory:

  • inspected from the image on-disk after it is pulled

  • installed packages, creation date, architecture, environment variables, detected licenses, etc.

[tianon]

Alright, this is updated to account for docker-library/repo-info#12 now. 👍

[tianon]

(probably easiest to review commit-by-commit, since the second commit reorders these two paragraphs)