-
Notifications
You must be signed in to change notification settings - Fork 595
Description
Description
docs: documentation for --output options is distributed
While writing up this comment moby/moby#50834 (comment) I noticed that the information about the --output flag is a bit distributed. I looked at the documentation for the flag (at https://docs.docker.com/reference/cli/docker/buildx/build/#output), then wanted to suggest that it's possible to specify the compression, but I couldn't find it on that page! "Search" in the docs didn't help immediately, but "Ask AI" did point me to the right page; https://docs.docker.com/build/exporters/#configuration-options.
That page is a bit in reverse; it has details on the compression, but is more "sparse" on the output types. We should probably make sure that at least the "compression" (and related) options are mentioned in the --output flag reference (but we could of course link to the other page for further details if we don't want to repeat).
I'm also wondering if the (subtle?) differences between the oci and docker outputs should get detailed a bit more; they describe that they're different (but the docker one also being OCI compliant), but don't really help me pick "which one should I use?"; i.e.
- do I lose information if I pick the
dockertype (will it discard the docker-specific additions to the spec)? - if I use
docker, are extra features, like attestations preserved, or are those only included in theocitype? - same; do both maintain multi-platform images, or if I use
oci? - can both be loaded using
docker image load?