Welcome to MergeBoard!

MergeBoard aims to fulfill your reviewing needs on multiple levels:

  • Always know, where you are needed

  • Never forget any change request

  • Communicate precisely with your author or reviewer

  • Understand changes in code logic faster and without the feeling of having missed something

MergeBoard is a browser based tool which you can reach via https://www.mergeboard.com.

Log in / Registration

Start Screen

Login & Register buttons

Logging in to MergeBoard is done by clicking the Login button in the top navigation bar or by navigating to /login. You can log in using either your username and password or a third party OAuth account, depending on the configuration of your MergeBoard instance.

Tip

Did you forget your password? No problem! Click Reset Password below the login form. You will receive an email, that asks you for confirmation and guides you through the process of setting a new password. Note that this is not supported for OAuth2 accounts if you haven’t set a password yet.

Registering is done similarly by clicking the Register button on the top navigation bar or navigating to /register and filling out the form. Make sure to enter a valid email address to receive the verification link. Your password must meet certain strength criteria: The longer and more uncommon it is, the better. Passwords like 12345678 or pAsSwOrD will be rejected 1. The password must be at least 8 characters long. If the Register button is not visible, you are either already logged in or the registration of new accounts has been disabled by an admin.

See also

The Top Navigation Bar

top navigation bar when logged out

Top navigation bar when logged out.

top navigation bar when logged in

Top navigation bar when logged in.

Common to all pages in MergeBoard is the top navigation bar. It shows slightly different options depending on if you are logged in.

From left to right:

MergeBoard Icon

By clicking on the MergeBoard icon you are either taken to the dashboard if you are logged in or to a welcome page if not.

Projects

Groups

Administration

Navigation buttons, that only show if you are logged in and, in case of the last one, if you are admin. These take you to the projects, groups and admin pages respectively.

Search Bar

The search bar allows you to search all merge requests by their name.

Register

Login

Allows you to log in or register.

User Menu
user menu

Clicking your icon will open a drop down menu that shows your user handle at the top, gives you a link to your user settings, allows you to log out and has a handle to switch between the default color mode and a colorblind version. As a colorblind person please let us know if the latter works for you or how we could improve it.

Help

The help button lets you access the documentation or send feedback to us directly.

The Dashboard

../_images/dashboard.png

Never loose track of your tasks with the dashboard. Where you are needed is highlighted by a red badge.

After logging in, you are redirected to your dashboard. This is the central place on MergeBoard to see the projects and merge requests you are involved in. It displays

  • the projects you were most recently active in,

  • the merge requests you opened,

  • the merge requests where you are assigned as reviewer.

Tip

You can always reach the dashboard by clicking the MergeBoard icon in the top navigation bar.

To make it easy for you to find out where you should to spend your time next, MergeBoard highlights those merge requests for you, that require your attention to move forward, by adding a red actor badge.

Let’s take a look at the various information that is displayed for a merge request.

../_images/merge_request_info.svg
title

The title of the merge request. Chosen by the author.

actor

The actor currently responsible for advancing the state of the merge request. This can take the values Author, Reviewer, CI or Scans pending, Ready to merge. If one of those roles applies to you, the badge will appear red.

Learn how MergeBoard computes these value in Actors.

state

The overall state of the merge request, i.e. Open, Closed or Merged as well as various icons for information about discussions, reviewers, authors and other activities.

details

The merge request id, when the merge request was opened, in which project and by which author.

progress

An indicator, how many of the change requests have been addressed.

branches

The names of the source and target branch for this merge request. If multiple remotes are configured for this project, the name of the corresponding remote will also be shown next to the branch if the remote is not the default “origin” one.

Footnotes

1

The strength of a password is calculated by compressing it using a list of most common passwords. The resulting number of bits needed to represent your password with this form of compression will then be compared against a minimum threshold that can be set by your admin but must at least be 60.