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.
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.
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.
Topics
Changes are automatically grouped into Topics—logical groupings that reflect how the change interacts with your system. For example:
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:
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