Re:Using ARG in a Dockerfile – beware the gotcha
by sergiotapia on Tuesday May 14, 2024 @08:01AM
(#40354250)
Documentation has to meet the user, not the other way around. Otherwise it's poor documentation. Docker should update their docs to show what 90%+ of people are interested in and leave the deep dives for later.
One has beautiful clear examples of what 99% of people are going to want to do. The other is some kind of secret language people must decipher, especially if they are new to the language. "What is 'm'? What is 'I'?"
Compare these two similar functions:
https://hexdocs.pm/elixir/1.12/Enum.html#map/2
https://modules.vlang.io/maps.html#to_array
One has beautiful clear examples of what 99% of people are going to want to do. The other is some kind of secret language people must decipher, especially if they are new to the language. "What is 'm'? What is 'I'?"
Docker can improve!