#17625 Document support for docker image dependencies New issue created by riisi In the current docs, it's not pointed out that docker images can depend on other images. This snippet implies that it's not supported:

A docker_image can depend on loose files belonging to file / files targets, and on artifacts packaged from a variety of targets, such as pex_binary , python_distribution, archive, or any other target that can be built via the package goal.

This blog post has a good explanation of multistage builds - possibly this could be folded into the docs as an additional section. Additionally, details on supported inference for upstream docker images in the FROM instruction should be added. The multi-stage build support is an extremely useful feature in my view and it would be good to highlight it. pantsbuild/pants