Branches
Branching allows you to create independent local versions of a catalog. You can freely make changes in these local versions, then publish them for peers and merge them with other branches in the catalog.
In the application interface, you can create branches, switch between them, merge, and delete them.
The Documentation Portal displays only one main branch. Changes from other branches are not visible to readers.
It is most convenient to make each change in an isolated branch. After approval, you can merge it with the main branch.

Add a Branch
A new branch is created from the current state of the catalog in the branch you are in at the time of creation.
To do this, click the button with the current branch name in the bottom right corner — the Branches window opens. Click and add a new branch.
The branch will become available to other users when you make the first publication.
Switch Branches
To switch branches, select the one you want to switch to in the Branches window.
The first time you switch, Gramax asks whether unpublished changes should be transferred between branches:
Transfer is on — unpublished changes move to the selected branch and remain unpublished.
Transfer is off — you cannot switch branches while there are unpublished changes. Publish or discard them first.
The choice is saved on the device. To stop the dialog from appearing on every switch, check Don't show this dialog again. You can change the mode later in the menu of the branches window — with the Transfer changes between branches toggle.
Following a link to an article in another branch uses the same mode.
Merge Branches
To merge branches, in the Branches window hover over the branch where you want to publish changes from the current branch. Click and select Instant merge. In the Merge branches window, select Delete branch after merge or Squash commits if needed, and click Merge.
The same branch menu also has Create merge request (see Review and Approval) and Delete.
When merging, changes from both branches are combined. If there are conflicting changes, Gramax will prompt you to resolve them.
If you delete a branch after merging, it cannot be restored in the Gramax interface.