Skip to content

Proofreading of chapter 1.#4417

Open
mpgreaves wants to merge 3 commits intokptdev:mainfrom
nokia:proofreading-chapter-1
Open

Proofreading of chapter 1.#4417
mpgreaves wants to merge 3 commits intokptdev:mainfrom
nokia:proofreading-chapter-1

Conversation

@mpgreaves
Copy link

No description provided.

Copilot AI review requested due to automatic review settings February 26, 2026 09:53
@netlify
Copy link

netlify bot commented Feb 26, 2026

Deploy Preview for kptdocs ready!

Name Link
🔨 Latest commit 7db9d3a
🔍 Latest deploy log https://app.netlify.com/projects/kptdocs/deploys/69b29462d259770008e36355
😎 Deploy Preview https://deploy-preview-4417--kptdocs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

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

@dosubot dosubot bot added size:L This PR changes 100-499 lines, ignoring generated files. documentation Improvements or additions to documentation labels Feb 26, 2026
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR proofreads Chapter 1 of the getting-started book section to improve readability, consistency, and phrasing.

Changes:

  • Rewrites the chapter description and multiple paragraphs for clarity and concision.
  • Normalizes heading capitalization and adjusts instructional phrasing throughout.
  • Improves grammar and flow in the quickstart/customization/apply/update/cleanup sections.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@dosubot
Copy link
Contributor

dosubot bot commented Feb 26, 2026

Related Documentation

Checked 76 published document(s) in 1 knowledge base(s). No updates required.

How did I do? Any feedback?  Join Discord

@dosubot dosubot bot added the lgtm label Mar 4, 2026
Copilot AI review requested due to automatic review settings March 12, 2026 10:07
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 2 comments.

Comments suppressed due to low confidence (1)

documentation/content/en/book/01-getting-started/_index.md:20

  • The text says to "Install" the kpt CLI using kpt version, but kpt version only verifies an existing installation. Consider rephrasing to something like "After installing the kpt CLI, verify it by running…" or update the command to an actual install step.
Install the [kpt CLI](installation/kpt-cli), using the following command:

```shell
kpt version
</details>



---

💡 <a href="/kptdev/kpt/new/main?filename=.github/instructions/*.instructions.md" class="Link--inTextBlock" target="_blank" rel="noopener noreferrer">Add Copilot custom instructions</a> for smarter, more guided reviews. <a href="https://docs.github.com/en/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot" class="Link--inTextBlock" target="_blank" rel="noopener noreferrer">Learn how to get started</a>.<br><br>You can also share your feedback on Copilot code review. [Take the survey](https://www.surveymonkey.com/r/XP6L3XJ).

mpgreaves and others added 3 commits March 12, 2026 11:23
Signed-off-by: Michael Greaves <michael.greaves@nokia.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Michael Greaves <michael.greaves@nokia.com>
Signed-off-by: Michael Greaves <michael.greaves@nokia.com>
@mpgreaves mpgreaves force-pushed the proofreading-chapter-1 branch from ca29d07 to 7db9d3a Compare March 12, 2026 10:24
Comment on lines -17 to 21
Install the [kpt CLI](installation/kpt-cli):
Install the [kpt CLI](installation/kpt-cli), using the following command:

```shell
kpt version
```

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That is not the installation command, but to check if you have it installed.

```

As you can see, this package contains 3 resources in 3 files. There is a special file named `Kptfile` which is used by
As can be seen, this package contains three resources in three files. There is a special file named `Kptfile`. This file is used by
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"As can be seen" sounds a little archaic to me.

I don't think we should split "...special file named Kptfile which is used by..." into two different sentences.


You might want to label all resources in the package. To achieve that, you can declare `set-labels` function in the
`pipeline` section of `Kptfile`. Add this by running the following command:
It might be a good idea to label all the resources in the package. To achieve this, you can declare the `set-labels` function, in the
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
It might be a good idea to label all the resources in the package. To achieve this, you can declare the `set-labels` function, in the
It might be a good idea to label all the resources in the package. To achieve this, you can declare the `set-labels` function in the

Congrats! You should now have a rough idea of what kpt is and what you can do
with it. Now, let's delve into the details.
You should now have a rough idea of what kpt is and what you can do
with it. Let us now delve into the details.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I agree with copilot here, "let us now" sounds too formal IMO.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation lgtm size:L This PR changes 100-499 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants