Skip to content

docs(#4556): Add comprehensive 3-way merge guide - #4654

Open
efiacor wants to merge 1 commit into
kptdev:mainfrom
Nordix:3way_merge_guide
Open

docs(#4556): Add comprehensive 3-way merge guide#4654
efiacor wants to merge 1 commit into
kptdev:mainfrom
Nordix:3way_merge_guide

Conversation

@efiacor

@efiacor efiacor commented Jul 21, 2026

Copy link
Copy Markdown
Contributor
  • Create new guide at documentation/content/en/guides/3-way-merge.md
  • Covers conceptual explanation, merge strategies, worked example, and best practices
  • Links to technical reference docs to avoid duplication
  • Includes practical workflow examples for security updates, version migration, and syncing
  • Add strategic cross-references:
    • Updated guides/_index.md with link to new guide
    • Updated reference/cli/pkg/update/_index.md with prominent callout
    • Added external links for Porch, Git merge, and Kubernetes SMPP
  • Explains Git integration: kpt uses field-level schema-aware merge vs Git's line-level merge

Closes #4556

- Create new guide at documentation/content/en/guides/3-way-merge.md
- Covers conceptual explanation, merge strategies, worked example, and best practices
- Links to technical reference docs to avoid duplication
- Includes practical workflow examples for security updates, version migration, and syncing
- Add strategic cross-references:
  - Updated guides/_index.md with link to new guide
  - Updated reference/cli/pkg/update/_index.md with prominent callout
  - Added external links for Porch, Git merge, and Kubernetes SMPP
- Explains Git integration: kpt uses field-level schema-aware merge vs Git's line-level merge
@efiacor efiacor self-assigned this Jul 21, 2026
@efiacor efiacor added the documentation Improvements or additions to documentation label Jul 21, 2026
@efiacor
efiacor requested review from a team July 21, 2026 17:10
@dosubot dosubot Bot added the size:L This PR changes 100-499 lines, ignoring generated files. label Jul 21, 2026
@netlify

netlify Bot commented Jul 21, 2026

Copy link
Copy Markdown

Deploy Preview for kptdocs ready!

Name Link
🔨 Latest commit 575b87a
🔍 Latest deploy log https://app.netlify.com/projects/kptdocs/deploys/6a5fa816792378000829182c
😎 Deploy Preview https://deploy-preview-4654--kptdocs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

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

@dosubot dosubot Bot added the lgtm label Jul 27, 2026
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.

versioning, 3-way merge needs to be brought into the kpt documentation

2 participants