Skip to content

Commit 37e6a11

Browse files
committed
build: bake guide grammatical improvements
Signed-off-by: David Karlsson <[email protected]>
1 parent 033acdf commit 37e6a11

File tree

1 file changed

+15
-16
lines changed

1 file changed

+15
-16
lines changed

content/guides/bake/index.md

Lines changed: 15 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -32,16 +32,16 @@ This guide assumes that you're familiar with:
3232

3333
## Prerequisites
3434

35-
- A recent version of Docker is installed on your machine.
36-
- Git is installed for cloning repositories.
35+
- You have a recent version of Docker installed on your machine.
36+
- You have Git installed for cloning repositories.
3737
- You're using the [containerd](/manuals/desktop/containerd.md) image store.
3838

3939
## Introduction
4040

4141
This guide uses an example project to demonstrate how Docker Buildx Bake can
42-
streamline your build and test workflows. This repository includes both a
43-
Dockerfile and `docker-bake.hcl`, giving you a ready-to-use setup to try out
44-
Bake commands.
42+
streamline your build and test workflows. The repository includes both a
43+
Dockerfile and a `docker-bake.hcl` file, giving you a ready-to-use setup to try
44+
out Bake commands.
4545

4646
Start by cloning the example repository:
4747

@@ -114,7 +114,7 @@ $ docker buildx build \
114114

115115
## Testing and linting
116116

117-
Bake isn't just for defining build configurations, and running builds. You can
117+
Bake isn't just for defining build configurations and running builds. You can
118118
also use Bake to run your tests, effectively using BuildKit as a task runner.
119119
Running your tests in containers is great for ensuring reproducible results.
120120
This section shows how to add two types of tests:
@@ -133,7 +133,7 @@ target "test" {
133133
```
134134

135135
> [!TIP]
136-
> Using the `type=cacheonly` ensures that the build output is effectively
136+
> Using `type=cacheonly` ensures that the build output is effectively
137137
> discarded; the layers are saved to BuildKit's cache, but Buildx will not
138138
> attempt to load the result to the Docker Engine's image store.
139139
>
@@ -145,7 +145,7 @@ you'll receive an error indicating that the `test` stage does not exist in the
145145
Dockerfile.
146146

147147
```console
148-
$ docker buildx bake bake test
148+
$ docker buildx bake test
149149
[+] Building 1.2s (6/6) FINISHED
150150
=> [internal] load local bake definitions
151151
...
@@ -252,13 +252,12 @@ combinations to build:
252252

253253
The `matrix` attribute defines the variants to build ("release" and "debug").
254254
The `name` attribute defines how the matrix gets expanded into multiple
255-
distinct build targets. In this case, it's relatively simple. The matrix
256-
attribute expands the build into two workflows: `image-release` and
257-
`image-debug`, each using different configuration parameters.
255+
distinct build targets. In this case, the matrix attribute expands the build
256+
into two workflows: `image-release` and `image-debug`, each using different
257+
configuration parameters.
258258

259-
Next, when building the development variant, we'll pass in a `BUILD_TAGS`
260-
argument with the value of the matrix variable, which we'll later consume in
261-
the Dockerfile.
259+
Next, define a build argument named `BUILD_TAGS` which takes the value of the
260+
matrix variable.
262261

263262
```diff {title="docker-bake.hcl"}
264263
target = "image"
@@ -365,7 +364,7 @@ bakeme:latest 20065d2c4d22 44.4MB 25.9MB
365364

366365
Exporting build artifacts like binaries can be useful for deploying to
367366
environments without Docker or Kubernetes. For example, if your programs are
368-
meant to be run on user's local machine.
367+
meant to be run on a user's local machine.
369368

370369
> [!TIP]
371370
> The techniques discussed in this section can be applied not only to build
@@ -502,7 +501,7 @@ multi-platform builds, testing, and artifact export. By integrating Buildx Bake
502501
into your projects, you can simplify your Docker builds, make your build
503502
configuration portable, and wrangle complex configurations more easily.
504503

505-
Experiment with different configurations and extend your Bake files to match
504+
Experiment with different configurations and extend your Bake files to suit
506505
your project's needs. You might consider integrating Bake into your CI/CD
507506
pipelines to automate builds, testing, and artifact deployment. The flexibility
508507
and power of Buildx Bake can significantly improve your development and

0 commit comments

Comments
 (0)