Diff Trees
The Diff Trees page is a powerful tool for visualizing and managing groups of dependent change requests. It lets you see the full dependency graph, detect file overlaps between CRs, and merge an entire tree in order.
Accessing Diff Trees
Navigate to your repository, click the Changes tab, and then click Diff Trees from the change request list page.
Dependency Graph
The top of the page shows an interactive SVG graph of the CR dependency tree. Each node represents a change request and displays:
- CR number and title (clickable link to the CR detail page).
- Current state badge (open, draft, stale, etc.).
- Source and target branch refs.
- Diffstat showing files added and removed.
- A readiness indicator: green dot means ready to merge, yellow means blocked.
Click a node to select it. Hover over a node to see tooltip details about why it may be blocked from merging.
Combined vs Incremental View
Two modes let you explore the changes in different ways:
- Combined — Shows the aggregated diff across all CRs in the tree as if they were all merged together. When files are modified by multiple CRs, the diff includes conflict markers showing overlapping changes.
- Incremental — Shows each CR's diff individually on separate tabs, listed in topological (merge) order.
Use the toggle button in the header to switch between modes.
File Overlap Detection
The page highlights files that are modified by more than one CR in the tree. This helps you identify potential conflicts before merging. Files changed by a single CR are listed separately.
Batch Merge
The Merge Full Tree button submits all CRs in the tree for merge in topological order (dependencies first). The button is disabled if any CR in the tree is not ready or has conflicts. Hover over the disabled button to see which CRs are blocking the merge.
Dependency Management
You can add or remove dependencies between CRs directly from this page. The dependency list shows each edge with color-coded CR badges.
Search and Navigation
The sidebar lists all dependency trees and standalone CRs. Use the search box to filter by CR title or number. Click a tree to focus the graph and diff display on that group.