Clarify docker volumes and their differences on windows, pc, and mac

docs.docker.com/storage/volumes/ のドキュメントから始め、そこにある volumes の説明を Dockerfile の VOLUME キーワードおよび --mount の例と比較してください。相対パスと絶対パス、ホスト上の場所、報告されるエラーを含め、Windows、macOS、PC 間の違いを明確にしてください。新しいユーザーが、いつ VOLUME が必要なのか、また各プラットフォームで volume のパスがどのように動作するのかを理解できれば完了です。

Is this a docs issue?

• My issue is about the documentation content or website

Type of issue

I can't find what I'm looking for

Description

I find the discussion of docker volumes very confusing. This person has helpfully written a gist here: https://gist.github.com/onlyphantom/0bffc5dcc25a756e247cb526c01072c0 with some extra info, however it still doesn't really explain the basics of what I am looking for.

1. How do docker volumes as discussed in https://docs.docker.com/storage/volumes/ relate to the VOLUME keyword in the DockerFile?
2. I am new to all this, but it isn't clear to me if I need to have a VOLUME specified in the dockerfile or not, and if I do what this does? Does it make changes to the host system that the image is built on by adding a volume? Does it add a volume when image is run as a container onto the container host?
3. I am on a mac and docker volume ls reports directories that do not exist? Can this be explained somewhere in the documentation?
4. when I use the commandline options as suggested for --mount I get errors that are meaningless to me. For example, the claim that I am not specifying an absolute path when I clearly am. Could this be documented in an FAQ somewhere?
5. what does it mean on a mac to set src=<relative_path>? Is this relative path relative to the path used by docker to store volumes? Where is that? Also, what then would be the meaning of the absolute path? My impression is that there is some missing information in the documentation on how this fits together.

Apologies, I am sure the answers to these questions are present. I just thought I ought to give the feedback of a thoroughly confused new user.

Location

https://docs.docker.com/storage/volumes/

Suggestion

No response