Skip to content

Commit 78c6d74

Browse files
committed
Remove hedge words and first-person plural from 5 prose hotspots
1 parent 6c977ff commit 78c6d74

5 files changed

Lines changed: 22 additions & 22 deletions

File tree

content/guides/bake/index.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -88,7 +88,7 @@ line. Here's a quick summary of the options for the `default` target:
8888
8989
- `platforms`: Platform variants to build.
9090

91-
To execute this build, simply run the following command in the root of the
91+
To execute this build, run the following command in the root of the
9292
repository:
9393

9494
```console
@@ -186,7 +186,7 @@ And in the Dockerfile, add the build stage. This stage will use the official
186186
> [!TIP]
187187
> Because this stage relies on executing an external dependency, it's generally
188188
> a good idea to define the version you want to use as a build argument. This
189-
> lets you more easily manage version upgrades in the future by collocating
189+
> lets you manage version upgrades in the future by collocating
190190
> dependency versions to the beginning of the Dockerfile.
191191
192192
```dockerfile {hl_lines=[2,"6-8"]}
@@ -267,7 +267,7 @@ matrix variable.
267267
```
268268

269269
You'll also want to change how the image tags are assigned to these builds.
270-
Currently, both matrix paths would generate the same image tag names, and
270+
As written, both matrix paths would generate the same image tag names, and
271271
overwrite each other. Update the `tags` attribute use a conditional operator to
272272
set the tag depending on the matrix variable value.
273273

@@ -498,7 +498,7 @@ build/
498498
Docker Buildx Bake streamlines complex build workflows, enabling efficient
499499
multi-platform builds, testing, and artifact export. By integrating Buildx Bake
500500
into your projects, you can simplify your Docker builds, make your build
501-
configuration portable, and wrangle complex configurations more easily.
501+
configuration portable, and wrangle complex configurations.
502502

503503
Experiment with different configurations and extend your Bake files to suit
504504
your project's needs. You might consider integrating Bake into your CI/CD

content/guides/genai-leveraging-rag/index.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ The system operates as follows:
3535
2. These patterns help find matching information in a database
3636
3. The LLM generates responses that blend the model's inherent knowledge with the this extra information.
3737

38-
To hold this vector information in an efficient manner, we need a special type of database.
38+
To hold this vector information in an efficient manner, you need a special type of database.
3939

4040
## Introduction to Graph databases
4141

@@ -110,7 +110,7 @@ The first startup may take some time because the system needs to download a larg
110110

111111
### Monitoring progress
112112

113-
We can monitor the download and initialization progress by viewing the logs. Run the following command to view the logs:
113+
You can monitor the download and initialization progress by viewing the logs. Run the following command to view the logs:
114114

115115
```bash
116116
docker compose logs
@@ -128,9 +128,9 @@ Wait for specific lines in the logs indicating that the download is complete and
128128

129129
You can now access the interface at [http://localhost:8501/](http://localhost:8501/) to ask questions. For example, you can try the sample question:
130130

131-
When we see those lines in the logs, web apps are ready to be used.
131+
When those lines appear in the logs, the web apps are ready to use.
132132

133-
Since our goal is to teach AI about things it does not yet know, we begin by asking it a simple question about Nifi at
133+
Since the goal is to teach AI about things it does not yet know, begin by asking it a simple question about Nifi at
134134
[http://localhost:8501/](http://localhost:8501/).
135135
![alt text](image.png)
136136

@@ -140,13 +140,13 @@ RAG: Disabled
140140
Hello! I'm here to help you with your question about Apache NiFi. Unfortunately, I don't know the answer to that question. I'm just an AI and my knowledge cutoff is December 2022, so I may not be familiar with the latest technologies or software. Can you please provide more context or details about Apache NiFi? Maybe there's something I can help you with related to it.
141141
```
142142

143-
As we can see, AI does not know anything about this subject because it did not exist during the time of its training, also known as the information cutoff point.
143+
As shown, the AI does not know anything about this subject because it did not exist during the time of its training, also known as the information cutoff point.
144144

145145
Now it's time to teach the AI some new tricks. First, connect to [http://localhost:8502/](http://localhost:8502/). Instead of using the "neo4j" tag, change it to the "apache-nifi" tag, then select the **Import** button.
146146

147147
![alt text](image-1.png)
148148

149-
After the import is successful, we can access Neo4j to verify the data.
149+
After the import is successful, you can access Neo4j to verify the data.
150150

151151
After logging in to [http://localhost:7474/](http://localhost:7474/) using the credentials from the `.env` file, you can run queries on Neo4j. Using the Neo4j Cypher query language, you can check for the data stored in the database.
152152

@@ -162,7 +162,7 @@ To execute this query, write in the box on the top and select the blue run butto
162162

163163
![alt text](image-2.png)
164164

165-
Results will appear below. What we are seeing here is the information system downloaded from Stack Overflow and saved in the graph database. RAG will utilize this information to enhance its responses.
165+
Results will appear below. The information shown is downloaded from Stack Overflow and saved in the graph database. RAG will utilize this information to enhance its responses.
166166

167167
You can also run the following query to visualize the data:
168168

@@ -176,7 +176,7 @@ To check the relationships in the database, run the following query:
176176
CALL db.relationshipTypes()
177177
```
178178

179-
Now, we are ready to enable our LLM to use this information. Go back to [http://localhost:8501/](http://localhost:8501/), enable the **RAG** checkbox, and ask the same question again. The LLM will now provide a more detailed answer.
179+
You're ready to enable the LLM to use this information. Go back to [http://localhost:8501/](http://localhost:8501/), enable the **RAG** checkbox, and ask the same question again. The LLM will provide a more detailed answer.
180180

181181
![alt text](image-3.png)
182182

@@ -209,7 +209,7 @@ For optimal results, choose a tag that the LLM is not familiar with.
209209

210210
### When to leverage RAG for optimal results
211211

212-
Retrieval-Augmented Generation (RAG) is particularly effective in scenarios where standard Large Language Models (LLMs) fall short. The three key areas where RAG excels are knowledge limitations, business requirements, and cost efficiency. Below, we explore these aspects in more detail.
212+
Retrieval-Augmented Generation (RAG) is particularly effective in scenarios where standard Large Language Models (LLMs) fall short. The three key areas where RAG excels are knowledge limitations, business requirements, and cost efficiency. The following sections explore these aspects in more detail.
213213

214214
#### Overcoming knowledge limitations
215215

content/guides/golang/build-images.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -195,7 +195,7 @@ This should be familiar. The result of that command will be a static application
195195
binary named `docker-gs-ping` and located in the root of the filesystem of the
196196
image that you are building. You could have put the binary into any other place
197197
you desire inside that image, the root directory has no special meaning in this
198-
regard. It's just convenient to use it to keep the file paths short for improved
198+
regard. It's convenient to use it to keep the file paths short for improved
199199
readability.
200200

201201
Now, all that is left to do is to tell Docker what command to run when your
@@ -275,7 +275,7 @@ $ docker build --tag docker-gs-ping .
275275
```
276276

277277
The build process will print some diagnostic messages as it goes through the build steps.
278-
The following is just an example of what these messages may look like.
278+
The following is an example of what these messages may look like.
279279

280280
```console
281281
[+] Building 2.2s (15/15) FINISHED
@@ -310,7 +310,7 @@ successfully built your image named `docker-gs-ping`.
310310

311311
To see the list of images you have on your local machine, you have two options.
312312
One is to use the CLI and the other is to use [Docker
313-
Desktop](/manuals/desktop/_index.md). Since you're currently working in the
313+
Desktop](/manuals/desktop/_index.md). Since you're working in the
314314
terminal, take a look at listing images with the CLI.
315315

316316
To list images, run the `docker image ls`command (or the `docker images` shorthand):
@@ -350,7 +350,7 @@ $ docker image tag docker-gs-ping:latest docker-gs-ping:v1.0
350350
```
351351

352352
The Docker `tag` command creates a new tag for the image. It doesn't create a
353-
new image. The tag points to the same image and is just another way to reference
353+
new image. The tag points to the same image and is another way to reference
354354
the image.
355355

356356
Now run the `docker image ls` command again to see the updated list of local
@@ -459,7 +459,7 @@ ENTRYPOINT ["/docker-gs-ping"]
459459
Since you have two Dockerfiles now, you have to tell Docker what Dockerfile
460460
you'd like to use to build the image. Tag the new image with `multistage`. This
461461
tag (like any other, apart from `latest`) has no special meaning for Docker,
462-
it's just something you chose.
462+
it's something you chose.
463463

464464
```console
465465
$ docker build -t docker-gs-ping:multistage -f Dockerfile.multistage .

content/guides/golang/develop.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -582,7 +582,7 @@ The exact value doesn't really matter for this example, because you run Cockroac
582582

583583
### Merging Compose files
584584

585-
The file name `compose.yaml` is the default file name which `docker compose` command recognizes if no `-f` flag is provided. This means you can have multiple Docker Compose files if your environment has such requirements. Furthermore, Docker Compose files are... composable (pun intended), so multiple files can be specified on the command line to merge parts of the configuration together. The following list is just a few examples of scenarios where such a feature would be very useful:
585+
The file name `compose.yaml` is the default file name which `docker compose` command recognizes if no `-f` flag is provided. This means you can have multiple Docker Compose files if your environment has such requirements. Furthermore, Docker Compose files are... composable (pun intended), so multiple files can be specified on the command line to merge parts of the configuration together. The following list shows a few examples of scenarios where such a feature would be very useful:
586586

587587
- Using a bind mount for the source code for local development but not when running the CI tests;
588588
- Switching between using a pre-built image for the frontend for some API application vs creating a bind mount for source code;

content/guides/rust/run-containers.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -173,7 +173,7 @@ Run the `docker ps --all` command again to see that Docker removed all container
173173

174174
Now, it's time to address the random naming issue. Standard practice is to name your containers for the simple reason that it's easier to identify what's running in the container and what application or service it's associated with.
175175

176-
To name a container, you just need to pass the `--name` flag to the `docker run` command.
176+
To name a container, pass the `--name` flag to the `docker run` command.
177177

178178
```console
179179
$ docker run -d -p 3001:8000 --name docker-rust-container docker-rust-image-dhi
@@ -183,11 +183,11 @@ CONTAINER ID IMAGE COMMAND CREATED
183183
219b2e3c7c38 docker-rust-image-dhi "/server" 6 seconds ago Up 5 seconds 0.0.0.0:3001->8000/tcp, [::]:3001->8000/tcp docker-rust-container
184184
```
185185

186-
That’s better! You can now easily identify your container based on the name.
186+
That’s better! You can now identify your container based on the name.
187187

188188
## Summary
189189

190-
In this section, you took a look at running containers. You also took a look at managing containers by starting, stopping, and restarting them. And finally, you looked at naming your containers so they are more easily identifiable.
190+
In this section, you took a look at running containers. You also took a look at managing containers by starting, stopping, and restarting them. And finally, you looked at naming your containers so they are more identifiable.
191191

192192
Related information:
193193

0 commit comments

Comments
 (0)