cli: make buildx build the canonical build

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>

content/build/building/packaging.md

@@ -38,7 +38,7 @@ Some projects may need distinct Dockerfiles for specific purposes. A common
 convention is to name these `<something>.Dockerfile`. You can specify the
 Dockerfile filename using the `--file` flag for the `docker build` command.
 Refer to the
-[`docker build` CLI reference](../../reference/cli/docker/image/build.md#file)
+[`docker build` CLI reference](../../reference/cli/docker/buildx/build.md#file)
 to learn about the `--file` flag.
 
 > **Note**

content/build/building/variables.md

@@ -117,7 +117,7 @@ $ docker build --build-arg NODE_VERSION=current .
 For more information on how to use build arguments, refer to:
 
 - [`ARG` Dockerfile reference](../../reference/dockerfile.md#arg)
-- [`docker build --build-arg` reference](../../reference/cli/docker/image/build.md#build-arg)
+- [`docker build --build-arg` reference](../../reference/cli/docker/buildx/build.md#build-arg)
 
 ## `ENV` usage example
 

content/build/guide/export.md

@@ -103,7 +103,7 @@ This is explored later on in this guide.
 
 Related information:
 
-- [`docker build --output` CLI reference](../../reference/cli/docker/image/build.md#output)
+- [`docker build --output` CLI reference](../../reference/cli/docker/buildx/build.md#output)
 - [Build exporters](../exporters/index.md)
 
 ## Next steps

content/build/guide/intro.md

@@ -160,7 +160,7 @@ container image and created a container from it.
 Related information:
 
 - [Dockerfile reference](../../reference/dockerfile.md)
-- [`docker build` CLI reference](../../reference/cli/docker/image/build.md)
+- [`docker build` CLI reference](../../reference/cli/docker/buildx/build.md)
 - [`docker run` CLI reference](../../reference/cli/docker/container/run.md)
 
 ## Next steps

content/develop/develop-images/instructions.md

@@ -330,7 +330,7 @@ as part of your build. `ADD` is better than manually adding files using
 something like `wget` and `tar`, because it ensures a more precise build cache.
 `ADD` also has built-in support for checksum validation of the remote
 resources, and a protocol for parsing branches, tags, and subdirectories from
-[Git URLs](../../reference/cli/docker/image/build.md#git-repositories).
+[Git URLs](../../reference/cli/docker/buildx/build.md#git-repositories).
 
 The following example uses `ADD` to download a .NET installer. Combined with
 multi-stage builds, only the .NET runtime remains in the final stage, no

content/docker-hub/builds/advanced.md

@@ -115,11 +115,11 @@ $ docker build --build-arg CUSTOM=$VAR -f $DOCKERFILE_PATH -t $IMAGE_NAME .
 
 > **Important**
 >
-> A `hooks/build` file overrides the basic [docker build](../../reference/cli/docker/image/build.md) command used by the builder, so you must include a similar build command in the hook or
+> A `hooks/build` file overrides the basic `docker build` command used by the builder, so you must include a similar build command in the hook or
 the automated build fails.
 { .important }
 
-Refer to the [docker build documentation](../../reference/cli/docker/image/build.md#build-arg)
+Refer to the [docker build documentation](../../reference/cli/docker/buildx/build.md#build-arg)
 to learn more about Docker build-time variables.
 
 #### Push to multiple repositories

content/guides/use-case/nlp/language-translation.md

@@ -262,7 +262,7 @@ To run the application using Docker:
      this case) is sent to the Docker daemon to enable the build. It includes
      all the files and subdirectories in the specified directory.
 
-   For more details, see the [docker build CLI reference](/reference/cli/docker/image/build/).
+   For more details, see the [docker build CLI reference](/reference/cli/docker/buildx/build/).
 
    Docker outputs several logs to your console as it builds the image. You'll
    see it download and install the dependencies. Depending on your network

content/guides/use-case/nlp/named-entity-recognition.md

@@ -269,7 +269,7 @@ To run the application using Docker:
      this case) is sent to the Docker daemon to enable the build. It includes
      all the files and subdirectories in the specified directory.
 
-   For more details, see the [docker build CLI reference](/reference/cli/docker/image/build/).
+   For more details, see the [docker build CLI reference](/reference/cli/docker/buildx/build/).
 
    Docker outputs several logs to your console as it builds the image. You'll
    see it download and install the dependencies. Depending on your network

content/guides/use-case/nlp/sentiment-analysis.md

@@ -287,7 +287,7 @@ To run the application using Docker:
    feature, so subsequent builds can be faster. The console will
    return to the prompt when it's complete.
 
-   For more details, see the [docker build CLI reference](/reference/cli/docker/image/build/).
+   For more details, see the [docker build CLI reference](/reference/cli/docker/buildx/build/).
 
 2. Run the image as a container.
 

content/guides/use-case/nlp/text-classification.md

@@ -341,7 +341,7 @@ To run the application using Docker:
      this case) is sent to the Docker daemon to enable the build. It includes
      all the files and subdirectories in the specified directory.
 
-   For more details, see the [docker build CLI reference](/reference/cli/docker/image/build/).
+   For more details, see the [docker build CLI reference](/reference/cli/docker/buildx/build/).
 
    Docker outputs several logs to your console as it builds the image. You'll
    see it download and install the dependencies. Depending on your network

content/guides/use-case/nlp/text-summarization.md

@@ -276,7 +276,7 @@ To run the application using Docker:
      this case) is sent to the Docker daemon to enable the build. It includes
      all the files and subdirectories in the specified directory.
 
-   For more details, see the [docker build CLI reference](/reference/cli/docker/image/build/).
+   For more details, see the [docker build CLI reference](/reference/cli/docker/buildx/build/).
 
    Docker outputs several logs to your console as it builds the image. You'll
    see it download and install the dependencies. Depending on your network

content/language/rust/build-images.md

@@ -174,7 +174,7 @@ Related information:
  - [Dockerfile reference](../../reference/dockerfile.md)
  - [.dockerignore file](../../reference/dockerfile.md#dockerignore-file)
  - [docker init CLI reference](../../reference/cli/docker/init.md)
- - [docker build CLI reference](../../reference/cli/docker/image/build.md)
+ - [docker build CLI reference](../../reference/cli/docker/buildx/build.md)
 
 
 ## Next steps

content/reference/cli/docker/image/build.md → content/reference/cli/docker/build-legacy.md

@@ -2,14 +2,7 @@
 datafolder: engine-cli
 datafile: docker_image_build
 linkTitle: docker build
-title: docker image build
-aliases:
-- /edge/engine/reference/commandline/image_build/
-- /engine/reference/commandline/image_build/
-- /engine/reference/commandline/build/
-- /engine/reference/commandline/builder_build/
-- /reference/cli/docker/build/
-- /reference/cli/docker/builder/build/
+title: docker build (legacy builder)
 layout: cli
 ---
 

content/reference/cli/docker/buildx/build.md

@@ -5,6 +5,13 @@ title: docker buildx build
 layout: cli
 aliases:
 - /engine/reference/commandline/buildx_build/
+- /edge/engine/reference/commandline/image_build/
+- /engine/reference/commandline/image_build/
+- /engine/reference/commandline/build/
+- /engine/reference/commandline/builder_build/
+- /reference/cli/docker/build/
+- /reference/cli/docker/builder/build/
+- /reference/cli/docker/image/build/
 ---
 
 <!--