Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add definitions for ambiguous tags in docs #197

Open
eightnoneone opened this issue Mar 8, 2024 · 1 comment
Open

Add definitions for ambiguous tags in docs #197

eightnoneone opened this issue Mar 8, 2024 · 1 comment
Labels
documentation Improvements or additions to documentation

Comments

@eightnoneone
Copy link

The current list of variant tags for images use terms that are not defined well.

Though some are terms of art that many Java developers and operators are familiar with, others are generic and ambiguous. The docker-library/docs README.md has a section for variants that only addresses alpine.

As single point of reference, I am a non-developer ops engineer that has been deploying Java applications for 25 years. This is what I understand from the tags:

  • jre - Just the runtime
  • jdk - Everything needed for compile, and the runtime
  • full - No idea how this is different from jdk
  • headless - Removed dependencies of GUI human interface, but is it jdk or jre?
  • headful - First use I've ever seen. Assumed opposite of headless, but how different from full or jdk?
  • generic - No idea
  • native - No idea
  • alpine - Well defined in docs README ✅
  • alpine3 - I assume a newer version of alpine, but I'm not an alpine guy so I'm not sure of the impact.
  • al2 - AmazonLinux2, but consider that may not be obvious to people outside the Amazon sphere.
  • al2023 - AmazonLinux2023, same issue as al2 and alpine3. How does this matter in my choice?

I would like to see more explicit definitions included in this repo's README and the docker-library/docs README.

@eightnoneone eightnoneone added the enhancement New feature or request label Mar 8, 2024
@caojoshua
Copy link
Contributor

Agreed that many of these labels are not obvious. We have this work planned internally. The updates will be in this repo's readme and the readme in docker-library

@caojoshua caojoshua added documentation Improvements or additions to documentation and removed enhancement New feature or request labels Mar 8, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

No branches or pull requests

2 participants