dotnet-buildtools-prereqs-docker
dotnet-buildtools-prereqs-docker copied to clipboard
Markdown file of supported tags
The current method for determining the available tags in this repo isn't great. There are only two sources of information:
- image info - This is a JSON file that includes a lot of metadata and isn't the easiest to visually parse
- all tags - This provides a view of every single tag, including those that are not supported
We should consider providing a markdown file that lists the supported tags in table format, in the same way that is done with the official container images. This would allow consumers of the images to more easily locate the available tags and select the one they need.
I'm in favor of status-quo. While everything about this repo is public, we're not trying to encourage the use of these images. It's OK if others use them, but there is no SLA/support for them. The lack of documentation on the images is a tacit statement about the SLA.
I see no reason to improve the experience for our own team. The JSON file seems sufficient to me. I've never had trouble using it.
The JSON file doesn't tell you that e.g. the azurelinux images are preferred over the old cbl-mariner ones. If we're concerned about SLA/support then we can just say so in the readme.
Chatted with @richlander offline. We agreed it will be acceptable to have a tags table represented. The support concerns have been addressed by https://github.com/dotnet/dotnet-buildtools-prereqs-docker/pull/1347.