diff --git a/docs/testing-deployment-publishing/branching-collaboration/branching.md b/docs/testing-deployment-publishing/branching-collaboration/branching.md index 4b5db2f6..dc3faf8a 100644 --- a/docs/testing-deployment-publishing/branching-collaboration/branching.md +++ b/docs/testing-deployment-publishing/branching-collaboration/branching.md @@ -515,4 +515,45 @@ YAML files play a key role in managing and resolving conflicts during the merge - YAML files allow you to manually edit and resolve conflicts during the merge process. - Since YAML files are text-based, they are version-controlled effectively, enabling multiple team members to make changes and merge their work.
- \ No newline at end of file + + ++Merging in Git is not like copying everything from one branch into another. It’s more like combining changes from two versions of a document based on a common starting point. + +Let’s say you and your friend both made changes to the same project: +- You both started with the same original version (this is called the common ancestor). +- You made your changes in `Branch A`. +- Your friend made changes in `Branch B`. + +When you merge `Branch B` into `Branch A`, Git compares: +- What changed in `Branch A` since the common starting point. +- What changed in `Branch B` since the common starting point. + +If both of you changed different parts, Git can merge them easily. But if you both changed the same part in different ways, Git won’t know which one to keep, that's called a conflict, and you'll need to resolve it manually. + + +
++Here are a few other things to know: +
++ +For example, you merge `Branch B` into `Branch A`, and `change C` (which exists in `Branch B`) gets copied over to `Branch A`. Later, you decide to undo `change C` directly on `Branch A`. Now, if you merge `Branch B` into `Branch A` again, Git will not re-flag `change C` as a difference. This is because Git considers it already merged and no longer a diff. + +
++ +Best Practice: Keep your branch histories short and simple. After each merge, delete the merged branch to avoid unnecessary complexity. For example, if you merge `Branch B` into `Branch A`, and later want to undo or revise those changes, don’t go back and modify `Branch B`. Instead, create a new branch (e.g., `Branch C`) from `Branch A` to make your updates. + +This approach prevents intertwining branch histories, avoids confusing merge behavior, and ensures clean, trackable diffs. Keeping branches focused and temporary makes merging more predictable and manageable. +
+