Skip to content

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

Merged
efiacor merged 1 commit into
kptdev:mainfrom
Nordix:3way_merge_guide
Aug 11, 2026
Merged

docs(#4556): Add comprehensive 3-way merge guide#4654
efiacor merged 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
@aravindtga
aravindtga requested review from a team August 5, 2026 16:37
@efiacor
efiacor merged commit c37d98d into kptdev:main Aug 11, 2026
25 checks passed
@efiacor
efiacor deleted the 3way_merge_guide branch August 11, 2026 09:21
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

4 participants