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

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. Compare these two similar functions: https://hexdocs.pm/elixir/1.12/Enum.html#map/2 https://hexdocs.pm/elixir/1.12/Enum.html#map/2 https://modules.vlang.io/maps.html#to_array 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!