Review and Approval

In Gramax, you can approve publishing changes from your branch to the main branch.

In the basic version of Gramax: any user who has published to the repository at least once can be an approver, and the number of approvers is unlimited. Their actions in the catalog are not restricted.

In Gramax Enterprise Server: approvers can be employees with an SSO account, even without a Gramax license. The number of approvers is also unlimited, and branch merging is possible without approval. There are additional limitations:

  • The approver can edit the request and leave comments, but can edit articles in other branches only if they are listed as an editor.

  • Approvers and their permissions can be managed by the space owner in the administration panel.

Create a Request

  1. Open the catalog and switch to the branch that contains your changes.

  2. Click the current branch name in the repository status bar. Next to the branch you want to merge into, click ... and select Create merge request.

  3. Fill in request details:

    1. Add approvers: type an email manually or click the search icon to find a user from the list.

    2. Enter a request description, for example, the task summary.

  4. Click Create request — it will appear as a draft.

  5. Publish changes so that the request becomes available to approvers. In the request, the status should change to Review.

View Changes

The merge request shows all changes across the whole catalog. You can see what happened to which articles using markers:

  • Green — file added. Highlights both new articles and any uploaded files in those articles (images, files, diagrams).

  • Blue — text changes in an article, or a file was replaced.

  • Purple — location changed. For example, an article was moved to another section.

  • Red — article or file deleted.

For each article in the request, the number of added and changed lines and whether comments exist are also shown. You can click any article and review changes the same way as during publishing.

Approve Request

If there are no comments, approve the request. Check the box in the panel next to your name.

Publish changes.

Merge Branches

  1. Open the catalog and switch to the branch where the merge request is open.

  2. Check that all approvers have approved the request.

  3. Click Merge branches. Confirm the action — changes from the current branch will be published to the selected branch, just like in a regular branch merge.