diff --git a/content/manuals/build/building/best-practices.md b/content/manuals/build/building/best-practices.md index 4e4bba5b5c09..cb863262a40d 100644 --- a/content/manuals/build/building/best-practices.md +++ b/content/manuals/build/building/best-practices.md @@ -114,9 +114,11 @@ $ docker build --no-cache -t my-image:my-tag . ``` This gets the latest available versions of dependencies from package -managers like `apt-get` or `npm`. However, `--no-cache` doesn't pull a -fresh base image - it only prevents reusing cached layers. For a -completely fresh build with the latest base image, combine both flags: +managers like `apt-get` or `npm`. It does not pull a fresh base image — +for that, use `--pull`. + +The two flags serve distinct purposes and can be combined. Use both +together to get a fresh base image and re-execute all build steps: ```console $ docker build --pull --no-cache -t my-image:my-tag .