build: add bake section

Signed-off-by: CrazyMax <crazy-max@users.noreply.github.com>

_config.yml

@@ -163,6 +163,14 @@ fetch-remote:
           - "!docs/README.md" # readme to make things nice in the compose-cli repo, but meaningless here
           - "!docs/architecture.md" # Compose-CLI architecture, unrelated to cloud integration
 
+  - repo: "https://github.com/docker/buildx"
+    default_branch: "master"
+    ref: "master"
+    paths:
+      - dest: "build/bake"
+        src:
+          - "docs/guides/bake/**"
+
   - repo: "https://github.com/distribution/distribution"
     default_branch: "main"
     ref: "release/2.7"

_data/toc.yaml

@@ -1401,7 +1401,21 @@ manuals:
         - path: /build/buildx/multiple-builders/
           title: Using multiple builders
         - path: /build/buildx/multiplatform-images/
-          title: Building multi-platform images                  
+          title: Building multi-platform images
+    - sectiontitle: Bake
+      section:
+        - path: /build/bake/
+          title: Bake overview
+        - path: /build/bake/file-definition/
+          title: File definition
+        - path: /build/bake/configuring-build/
+          title: Configuring builds
+        - path: /build/bake/hcl-funcs/
+          title: User defined HCL functions
+        - path: /build/bake/build-contexts/
+          title: Build contexts and linking targets
+        - path: /build/bake/compose-file/
+          title: Building from Compose file
 - sectiontitle: Docker Compose
   section:
   - path: /compose/

build/bake/build-contexts.md

@@ -0,0 +1,7 @@
+---
+title: "Defining additional build contexts and linking targets"
+keywords: build, buildx, bake, buildkit, hcl
+fetch_remote:
+  line_start: 2
+  line_end: -1
+---

build/bake/compose-file.md

@@ -0,0 +1,7 @@
+---
+title: "Building from Compose file"
+keywords: build, buildx, bake, buildkit, compose
+fetch_remote:
+  line_start: 2
+  line_end: -1
+---

build/bake/configuring-build.md

@@ -0,0 +1,7 @@
+---
+title: "Configuring builds"
+keywords: build, buildx, bake, buildkit, hcl, json
+fetch_remote:
+  line_start: 2
+  line_end: -1
+---

build/bake/file-definition.md

@@ -0,0 +1,7 @@
+---
+title: "Bake file definition"
+keywords: build, buildx, bake, buildkit, hcl, json, compose
+fetch_remote:
+  line_start: 2
+  line_end: -1
+---

build/bake/hcl-funcs.md

@@ -0,0 +1,7 @@
+---
+title: "User defined HCL functions"
+keywords: build, buildx, bake, buildkit, hcl
+fetch_remote:
+  line_start: 2
+  line_end: -1
+---

build/bake/index.md

@@ -0,0 +1,7 @@
+---
+title: "High-level build options with Bake"
+keywords: build, buildx, bake, buildkit, hcl, json, compose
+fetch_remote:
+  line_start: 2
+  line_end: -1
+---

build/buildx/index.md

@@ -48,25 +48,7 @@ other drivers, the method for outputting an image needs to be selected
 with `--output`.
 
 
-## High-level build options
+## High-level build options with Bake
 
-Buildx also aims to provide support for high-level build concepts that go beyond
-invoking a single build command.
-
-BuildKit efficiently handles multiple concurrent build requests and de-duplicating
-work. The build commands can be combined with general-purpose command runners
-(for example, `make`). However, these tools generally invoke builds in sequence
-and therefore cannot leverage the full potential of BuildKit parallelization,
-or combine BuildKit’s output for the user. For this use case, we have added a
-command called [`docker buildx bake`](../../engine/reference/commandline/buildx_bake.md).
-
-The `bake` command supports building images from compose files, similar to
-[`docker-compose build`](../../engine/reference/commandline/compose_build.md),
-but allowing all the services to be built concurrently as part of a single
-request.
-
-There is also support for custom build rules from HCL/JSON files allowing
-better code reuse and different target groups. The design of bake is in very
-early stages, and we are looking for feedback from users. Let us know your
-feedback by creating an issue in the [Docker Buildx](https://github.com/docker/buildx/issues){:target="_blank" rel="noopener" class="_"}
-GitHub repository.
+Check out our guide about [Bake](../bake/index.md) to get started with the
+[`docker buildx bake` command](../../engine/reference/commandline/buildx_bake.md).

build/index.md

@@ -64,8 +64,7 @@ Automate your image builds to run in GitHub actions using the official docker bu
 
 * **Orchestrating builds across complex projects together**  
 Connect your builds together and easily parameterize your images using buildx bake.  
-<!--replace when Bake content is onboarded -->
-See [High-level build options](buildx/index.md/#high-level-build-options)
+See [High-level build options with Bake](bake/index.md).
 
 ### Customizing your Builds
 

compose/compose-file/build.md

@@ -302,4 +302,4 @@ build:
 ## Implementations
 
 * [docker-compose](https://docs.docker.com/compose)
-* [buildX bake](https://docs.docker.com/buildx/working-with-buildx/)
+* [buildx bake](../../build/bake/index.md)