Open
Description
The current --mount documentation skips straight from the brief statement overview for --mount itself and the listing of all supported types straight into the description for the options for each type (i.e. no description for the types themselves).
It would be beneficial to have a section that describes the function of each individual mount type. Visually, my request is:
--mount=type=TYPE,TYPE-SPECIFIC-OPTION[,…]
Attach a filesystem mount to the container.
Current supported mount TYPEs are artifact, bind, devpts, glob, image, ramfs, tmpfs and volume.
<PARAGRAPH(S) DESCRIBING WHAT EACH TYPE DOES HERE>
Options common to all mount types:
<...>
For reference, here is the Docker section that provides an overview for each of their supported mount types.
On top of general overviews of each type, it would be nice to have example use cases for each (i.e. "When to use TYPE mount"). Docker includes such sections for both its volume and bind mount options.