References & Milestones

when looking at results, it is important to compare them to a reference. It could to a previous version, results from a benchmark

Comparing versus a reference

In results pages, QA-Board always compares the commit you selected (labeled new) versus a reference (ref):

new-vs-reference

The reference is by default the latest commit from the project's reference branch:

qaboard.yaml
project:
reference_branch: master

To change the selected new or ref commit, you can edit the commit ID field in the navbar. Hovering it gives you a menu with other options:

commit-select-menu.png
tip

Clicking on the branch name in the navbar will select the latest commit on the branch.

Project References

You can also list in qaboard.yaml other versions as milestones.

qaboard.yaml
project:
reference_branch: master
milestones:
- release/v1.0.0 # tag
- feature/better-perf # branch
- e45123a3565 # commit id

Defining Milestones from QA-Board

Every user can save milestones with the “star” icon in each commit navbar:

save-as-milestone

If needed, you can give them a name and leave notes:

milestone-details

You'll now be able to select them in the commit ID hover menu.

tip

Milestones can be shared with everybody - or kept private.