Changes

The changes view shows you all the changes introduced by this merge request.

An example changes view of a merge request based on commit 15a46bc0 from the open source project GORM (license: MIT).

The changes view shows you all changes that are introduced by this merge request. It is very similar to the Commits view in that it summarizes all changes introduced by all commits. Many of the elements presented here are discussed in more detail in Code Review and Diffs.

Elements

Identifiers for specific areas of the example merge request changes view above.

1 Sidebar

The sidebar contains the following elements from top to bottom:

Navigation Elements

Switch between the Overview, Commits or Changes view.

Revision Control

Choose which revision you want to diff against which. By default the diff you are seeing is between the latest revision and the branch you want to merge into.

Diff Mode

Choose how you want your diffs displayed: Normal, Ignore Whitespace and SemanticDiff.

Threads

Using the Hide All button you can collapse all threads that are shown in the diff. Clicking Show All will uncollapse all threads.

File Tree

The last element in the sidebar is the file tree, that shows all files that were changed in this commit. You can collapse folders by clicking them and get additional information on files when you hover the latter. At the right of each file is an indicator of how many lines were added (green) and deleted (red). The indicator works logarithmically, i.e. each bar stands for a power of 10:

1 bar

\(<\) 10 lines changed,

2 bars

\(\geq\) 10 and \(<\) 100 lines changed,

3 bars

\(\geq\) 100 lines changed.

2 Threads

The thread list displays all threads that reference code visible on the current page. For example, if you click through the commits of a merge request, only threads that reference code in the current commit are shown.

For each thread the following information is shown:

• the color used to indicate the code references (left border color),

• the author,

• the number of replies for this thread (blue badge with number),

• a preview of the comments content,

• whether a change request was fixed (first check mark) and approved (second check mark),

• a pending badge if the thread was not published yet.

By hovering over a thread, you can see how many code references are visible on the current page. Click on the up and down arrow buttons to cycle through the references. The browser will scroll to the corresponding code area and the code reference blinks slowly.

By double clicking on a thread, the browser scrolls to the associated comment.

3 Minimap

Another handy tool is the minimap, which lets you quickly navigate the diff by clicking it where you want to go. A white overlay always shows you what part of the diff you are currently seeing.

4 Diff

The main body of this view is the diff, i.e. a visualization of all changes introduced in the current commit.

Each file is shown as a separate block with its name or path in the top header. You can collapse files by clicking this header. Large files are collapsed by default. To view not only the changes but the entire file, click the View button in the file header. To get more context around changes, hover with the mouse in the vicinity of the change until you see the show more button and click it.

Please take a look at Diffs to learn more how MergeBoard displays changes and how to interpret them.