Build mounts guide + rw "discard" behavior

[milas]

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

In the Dockerfile reference @ https://docs.docker.com/reference/dockerfile/#run---mounttypebind, the docs for the rw param mention:

Written data will be discarded.

This is not covered anywhere in the guide for build mounts, which leads to the assumption that they behave like run mounts, which are bi-directional.

Location

https://docs.docker.com/build/guide/mounts/

Suggestion

Add a short explanation about the use-case for read-write mounts with clarification that they do NOT propagate back to the host and that all "written data will be discarded".

[dvdksn]

Cheers @milas - good callout! I agree that this deserves clarification, it's in my todo pile.

[docker-robot]

There hasn't been any activity on this issue for a long time.
If the problem is still relevant, mark the issue as fresh with a /remove-lifecycle stale comment.
If not, this issue will be closed in 14 days. This helps our maintainers focus on the active issues.

Prevent issues from auto-closing with a /lifecycle frozen comment.

/lifecycle stale