Incorrect documentation

[anthonymaers]

Is this a docs issue?

• [x] My issue is about the documentation content or website

Type of issue

Information is incorrect

Description

This documentation clearly states "Using the --no-cache, you can avoid cache hits and ensure a fresh download of base images and dependencies." but I do not believe it is true that --no-cache fetches a new download of the base images referenced in the dockerfile. It only ignores the build cache for layers but does not pull a new base image. Please correct me if I am wrong.

Location

https://docs.docker.com/build/building/best-practices/

Suggestion

Please make it more clear how --no-cache affects the base image vs other layers and how it differs from --pull.