Skip to main content

Issues and PRs > Base ref | Branch

Tom Williams avatar
Written by Tom Williams
Updated over a week ago

Dataset: Issues & Pull Requests

Entity: Pull Requests, Issues

Field ID: base_ref_branch

Type: Text

Description: The branch of the base ref (destination branch).

Source: App

Transformation logic: N/A

From:

Github (PRs)

base_ref_name

Gitlab (PRs)

target_branch

Bitbucket (PRs)

destination.branch.name

Azure DevOps (PRs, Issues)

targetRefName

JIRA

N/A

ClickUp

N/A

Trello

N/A


Reporting Use Cases

The Base Ref Branch field is essential for understanding your development workflow and tracking where code changes are being deployed. As a text field, it is primarily used for filtering reports and as a dimension to categorize your pull requests.

  • Filtering and Scoping: You can focus your insights on the streams of work that matter most by filtering on the destination branch.

    • Production Deployments: Create reports that only include pull requests merged into your main production branch by using a filter like Base Ref Branch = main.

    • Release Monitoring: Use a regex filter such as Base Ref Branch ~ ^release- to monitor all pull requests related to a specific release cycle.

    • Excluding Hotfixes: If you want to analyze feature work separately, you can exclude urgent fixes with a filter like Base Ref Branch !~ ^hotfix-.

  • Reporting and Analysis: Using Base Ref Branch as a dimension allows you to compare different development streams.

    • Activity per Branch: A bar chart with Base Ref Branch as the dimension and COUNT() as the metric can visualize which branches are the most active, helping you understand where development effort is concentrated.

    • Performance Metrics per Branch: You can analyze if the review process differs by branch. For example, group the average cycle time by Base Ref Branch to see if pull requests targeting main are processed faster or slower than those targeting a develop branch.

  • Custom Formulas and Categorization: You can use custom formulas to group various branches into logical categories for simpler, high-level reporting.

    • For instance, you could categorize your work into "Production" and "Pre-production" streams using a formula in a dimension like IF(base_ref_branch == 'main', 'Production', 'Pre-production'). This makes it easier to compare the volume and velocity of work destined for different environments.​

Did this answer your question?