Skip to content

Proofreading chapter 2#4487

Open
mpgreaves wants to merge 7 commits intokptdev:mainfrom
nokia:proofreading-chapter-2
Open

Proofreading chapter 2#4487
mpgreaves wants to merge 7 commits intokptdev:mainfrom
nokia:proofreading-chapter-2

Conversation

@mpgreaves
Copy link
Copy Markdown
Contributor

No description provided.

Signed-off-by: Michael Greaves <michael.greaves@nokia.com>
Signed-off-by: Michael Greaves <michael.greaves@nokia.com>
Signed-off-by: Michael Greaves <michael.greaves@nokia.com>
Signed-off-by: Michael Greaves <michael.greaves@nokia.com>
Copilot AI review requested due to automatic review settings April 16, 2026 09:00
@dosubot dosubot Bot added the size:L This PR changes 100-499 lines, ignoring generated files. label Apr 16, 2026
@netlify
Copy link
Copy Markdown

netlify Bot commented Apr 16, 2026

Deploy Preview for kptdocs ready!

Name Link
🔨 Latest commit 68383cf
🔍 Latest deploy log https://app.netlify.com/projects/kptdocs/deploys/69e9e33207fe440008b44087
😎 Deploy Preview https://deploy-preview-4487--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 the documentation Improvements or additions to documentation label Apr 16, 2026
Copy link
Copy Markdown
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 and rephrases Chapter 2 (“Concepts”) of the kpt book, aiming to improve clarity and readability of the documentation content.

Changes:

  • Reworded multiple sections for improved grammar and readability.
  • Restructured several paragraphs into bullet/numbered lists and expanded some explanations.
  • Updated wording and formatting across the “Packages”, “Workflows”, and “Functions” sections.

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

Comment thread documentation/content/en/book/02-concepts/_index.md Outdated
Comment thread documentation/content/en/book/02-concepts/_index.md
Comment thread documentation/content/en/book/02-concepts/_index.md
Comment thread documentation/content/en/book/02-concepts/_index.md Outdated
Comment thread documentation/content/en/book/02-concepts/_index.md Outdated
Comment thread documentation/content/en/book/02-concepts/_index.md Outdated
Comment thread documentation/content/en/book/02-concepts/_index.md Outdated
Comment thread documentation/content/en/book/02-concepts/_index.md Outdated
Signed-off-by: Michael Greaves <michael.greaves@nokia.com>
Assisted-by: Copilot Code Review: not-known

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings April 23, 2026 08:59
Copy link
Copy Markdown
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.


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

Comment thread documentation/content/en/book/02-concepts/_index.md Outdated
Comment thread documentation/content/en/book/02-concepts/_index.md Outdated
mpgreaves and others added 2 commits April 23, 2026 11:06
Signed-off-by: Michael Greaves <michael.greaves@nokia.com>
Signed-off-by: Michael Greaves <michael.greaves@nokia.com>
Assisted-by: Copilot Code Review: not-known

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings April 23, 2026 09:15
Copy link
Copy Markdown
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.


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


A kpt package is a bundle of configuration _data_. It is represented as a directory tree containing KRM resources using
YAML as the file format.
A package is explicitly declared using a file named `Kptfile`. This file contains a KRM resource of type `Kptfile`. The Kptfile contains metadata about the package and is simply a regular resource in the YAML format.
Copy link

Copilot AI Apr 23, 2026

Choose a reason for hiding this comment

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

In the Kptfile description, Kubernetes/YAML terminology is off: the embedded resource uses kind: Kptfile (not “type Kptfile”). Please change this wording to “resource of kind Kptfile” to match the actual field name used in all Kptfile examples elsewhere in the docs.

Suggested change
A package is explicitly declared using a file named `Kptfile`. This file contains a KRM resource of type `Kptfile`. The Kptfile contains metadata about the package and is simply a regular resource in the YAML format.
A package is explicitly declared using a file named `Kptfile`. This file contains a KRM resource of kind `Kptfile`. The Kptfile contains metadata about the package and is simply a regular resource in the YAML format.

Copilot uses AI. Check for mistakes.
@@ -129,18 +107,15 @@ status:
pipeline.run: must run with `--allow-exec` option to allow running function binaries
Copy link

Copilot AI Apr 23, 2026

Choose a reason for hiding this comment

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

The YAML failure example contains a tab before pipeline.run, which makes the YAML invalid (YAML indentation must use spaces). Replace the tab with spaces so the example is copy/pasteable and valid YAML.

Suggested change
pipeline.run: must run with `--allow-exec` option to allow running function binaries
pipeline.run: must run with `--allow-exec` option to allow running function binaries

Copilot uses AI. Check for mistakes.
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 size:L This PR changes 100-499 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants