cli: make buildx build the canonical build

[dvdksn]

Description

Make buildx build the canonical build command

docker build
docker build (legacy builder)

Related issues or tickets

• docs: make buildx build the canonical reference doc cli#5002
• docs: make buildx build the canonical doc buildx#2397

[netlify]

✅ Deploy Preview for docsdocker ready!

Name	Link
🔨 Latest commit	02caff9
🔍 Latest deploy log	https://app.netlify.com/sites/docsdocker/deploys/66277f5228d1dc0008751285
😎 Deploy Preview	https://deploy-preview-19774--docsdocker.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site configuration.

[dvdksn]

@thaJeztah @crazy-max I started looking at making buildx build the canonical CLI reference page for docker build, and repurposing the prevous docker [image] build page to cover only the legacy builder.

[crazy-max]

@thaJeztah @crazy-max I started looking at making buildx build the canonical CLI reference page for docker build, and repurposing the prevous docker [image] build page to cover only the legacy builder.

Should we also duplicate/copy related reference docs missing in https://github.com/docker/buildx/blob/master/docs/reference/buildx_build.md?

Edit: nevermind docker/buildx#2397

[dvdksn]

I pretty much just moved the flag descriptions for things like --build-arg without touching them. Might need to update some things.

Wondering if we should use docker build or docker buildx build in the examples on the Buildx reference page after this.

[dvdksn]

Also this diff is showing what's on master for buildx, so not appropriate for merging here, just included to show what it will look like. Will need to backport to 0.13 branch if we want to release before 0.14. Maybe easier to do after that release.

[crazy-max]

Wondering if we should use docker build or docker buildx build in the examples on the Buildx reference page after this.

I think using canonical docker buildx build would be better in GitHub markdown