Skip to content
This repository was archived by the owner on Nov 24, 2024. It is now read-only.

Commit b088a76

Browse files
committed
BlenderBIM document Git merge asymmetry (IfcOpenShell#3096)
1 parent 104fe56 commit b088a76

1 file changed

Lines changed: 11 additions & 0 deletions

File tree

src/blenderbim/docs/users/git_support.rst

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -145,6 +145,17 @@ combined changes before discarding or committing them.
145145
Merging requires the *ifcmerge* tool installed in your `PATH`, if it is
146146
not installed the merge operator will not be enabled.
147147

148+
When two branches have diverged, merging an IFC model requires *conflict
149+
resolution* (because added entities may inadvertently reuse the same Step-IDs),
150+
this means that data on one side or the other may be rewritten by BlenderBIM in
151+
order to accomodate both sets of changes. ie. the merge process is
152+
*asymmetrical*. BlenderBIM privileges data in the remote `origin/main` branch
153+
over the local working branch, similarly it privileges data in the local `main`
154+
branch over any other local working branch. The practical result of this is
155+
that branches branched-off the `main` branch can generally be merged back into
156+
`main`, but any sub-branches of these will need to be merged back into their
157+
parent-branch *before* merging the parent-branch back into `main`.
158+
148159
Tags
149160
----
150161

0 commit comments

Comments
 (0)