Hacker News new | ask | show | jobs
by sergiotapia 762 days ago
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://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!