Code Review

The Changes page is where active Change Requests are reviewed, discussed, and approved. It’s organized around visibility, clarity, and efficient navigation of what’s changed and why.

Change List

At the top level, Baz presents a list of open Change Requests. Each entry includes its title, repository, author, status, and a quick summary of what was changed—number of files, lines added/removed, and when the CR was last updated. This gives reviewers a fast way to prioritize what to look at next.

Change List

Inside a Change Request

Opening a Change Request reveals a rich review workspace. The layout includes the change graph, a generated description, topics, the diff viewer, and tools for AI and collaboration.

Inside a Change

Graph and Description

Baz automatically generates a visual graph showing relationships between code elements. This includes added, modified, and removed components, helping reviewers understand how changes propagate across modules.

Below the graph, a plain-language description summarizes the CR. It includes the motivation behind the change, the architectural impact, and which APIs or services are affected.

CR Graph

Topics

Changes are automatically grouped into Topics—logical groupings that reflect how the change interacts with your system. For example:

Topic
Examples of what it might include

Analysis Engine

Updates to language parsers or analyzers

Git Operations

Modifications to clone, checkout, or repository handling

Service Setup

Infrastructure, Helm, or deployment-related changes

Each topic lists the number of affected lines or files, helping you focus on the areas with the most weight.

Diffing

The diff viewer supports both standard line-by-line diffs and AST (Abstract Syntax Tree) diffs. Standard view highlights additions and deletions in raw code. AST diffing shows structural changes—useful for identifying semantic updates, like function signature rewrites or refactored logic—without being distracted by indentation or formatting noise.

Ask AI

You can right-click any line or block of code to ask Baz’s AI for help. The available actions include:

Action
What it does

Comment

Drafts a code review comment explaining the selected block

Suggest

Proposes a direct code suggestion

Explain

Summarizes what the code does and its purpose

Suggest better code

Rewrites the snippet for readability or performance

Ask Bazzy

Opens a conversational window to ask broader questions

These actions help reviewers move faster while maintaining review quality.

Discussions

Comments and threads are integrated directly into the diff. You can open, resolve, and reply to threads without switching views. Comments support markdown and are pinned to specific lines. If a thread is unresolved and marked as a Merge Blocker, it will prevent approval until resolved.

Last updated