Reviews for Jira

Complete guide to streamlining your code review process in Jira

Table of Contents

Overview

Reviews for Jira is a comprehensive code review management plugin that integrates seamlessly into your Jira workflow. This plugin transforms Jira into a powerful code review platform, allowing teams to manage, track, and automate review processes directly within their existing project management environment.

🚀 Key Benefits

  • Structured Review Process: Create standardized review workflows with custom forms and fields
  • Integrated Workflow: Manage code reviews alongside other project tasks without context switching
  • Automated Assignment: Automatically assign reviewers based on configurable rules and requirements
  • Progress Tracking: Monitor review status, completion rates, and bottlenecks in real-time
  • Compliance Ready: Maintain audit trails and ensure review requirements are met before deployment
  • Customizable Forms: Configure review templates specific to your team's needs and standards
  • Rule-Based Automation: Set up intelligent rules that automatically update fields based on status changes

Installation & Setup

1. Plugin Installation

  1. Navigate to Jira Administration → Apps → Find new apps
  2. Search for "Reviews for Jira" by NewSysRS
  3. Click Install and follow the installation prompts
  4. Once installed, the plugin will appear in your project's navigation bar

2. Initial Access

After installation, you'll find "Reviews for Jira" in your project's top navigation bar. Click it to access the review management interface.

Configuration Guide

Before using the review features, you must configure the plugin for your project. This is typically done by project administrators.

Basic Setup

Navigate to the Settings tab in the Reviews for Jira interface.

Required Configurations:

  • Issue Type for Reviews: Select the Jira issue type that will represent review requests
  • Issue Type for Reviewers: Choose the issue type for individual reviewer assignments
  • Link Type for Requirements: Select how reviews will be linked to requirements or stories
  • Default Review Description: Set a template description that appears in new review requests

Field Configuration:

Review Fields

  • Summary, Description, Priority
  • Due Date, Custom Fields

Reviewer Fields

  • Assignee, Status, Comments
  • Score/Rating (optional)

Advanced: Requirement Rules

Set up automated rules that trigger when review statuses change:

Example Rule:

  • Trigger: Review status changes from "In Progress" to "Complete"
  • Condition: All reviewer sub-issues are "Done"
  • Action: Update parent story status to "Ready for Deploy"
Reviews for Jira Settings

Configure advanced settings and automation rules

Daily Usage Workflows

The Reviews for Jira interface has three main tabs for different user roles and tasks.

1. Reviewer Tasks Tab

Purpose: Shows reviews assigned to you as a reviewer

Reviewer Tasks Interface

View and manage reviews assigned to you

Workflow:

  1. Click on any review to open it
  2. Review the code/requirements linked to the request
  3. Update your reviewer status (In Progress → Complete)
  4. Add comments or feedback
  5. Complete your review assignment

2. Review Tasks Tab

Purpose: Shows reviews you've created or are responsible for

Review Tasks List

Monitor and manage all your created review requests

Workflow:

  1. Monitor progress of your review requests
  2. Follow up with reviewers if needed
  3. Check completion status
  4. Close reviews when all requirements are met

3. Create Tab

Purpose: Create new review requests

Create Review Interface

Create new review requests with detailed configuration options

Step-by-Step Creation Process:

  1. Review Summary: Enter a clear, descriptive title
  2. Review Description: Provide detailed review requirements and context
  3. Link to Issues: Connect the review to related stories, bugs, or requirements
  4. Review Parent: Set the parent issue if using hierarchical structure
  5. Requirements: Select specific requirements or user stories to review
  6. Custom Fields: Fill in any configured project-specific fields
  7. Add Reviewers: Click "Add Reviewer" and configure reviewer-specific fields
  8. Create: Submit the review request

Advanced Features

Requirement Rules Automation

Create intelligent automation that responds to review progress:

  • Auto-Approve Pattern: When all reviewers mark complete → Set review status to "Approved"
  • Escalation Pattern: When review open > 3 days → Notify project manager
  • Quality Gates: When review complete → Require all linked tests to pass

Custom Workflows

Integration with existing Jira workflows:

  • Link reviews to your deployment pipeline
  • Require review completion before story closure
  • Automatically create reviews when stories move to "Ready for Review"
  • Multi-stage reviews for different aspects

Reporting and Metrics

Use Jira's built-in reporting with review data:

  • Review Velocity: How quickly reviews are completed
  • Bottleneck Analysis: Which reviewers or review types cause delays
  • Coverage Metrics: Percentage of code changes reviewed
  • Quality Trends: Review feedback and issue discovery rates

Best Practices

Review Request Best Practices

Clear Summaries:

✅ "Review: User Authentication API Changes"

❌ "Code Review"

  • Detailed Context: Provide background, requirements, and specific areas of focus
  • Right-Size Reviews: Keep reviews focused and manageable (30-60 minutes)

Reviewer Assignment Strategy

  • Expertise Matching: Assign reviewers based on domain knowledge
  • Load Balancing: Distribute review workload evenly
  • Cross-Training: Occasionally assign reviews outside expertise areas

Review Process Optimization

Standard Templates

  • API changes checklist
  • Database migration review
  • Security review requirements

Automation Integration

  • Link to pull requests
  • Integrate with CI/CD pipeline
  • Automatic reviewer notifications

Feedback Culture

  • Focus on code, not person
  • Suggest improvements
  • Celebrate learning opportunities

Troubleshooting

Common Issues

Plugin Not Visible:

  • Check project permissions
  • Verify plugin is enabled
  • Contact administrator

Configuration Required Error:

  • Ensure issue types are selected in Settings
  • Verify link types are configured

Getting Help

  1. Documentation: Refer to this guide and project-specific documentation
  2. Administrator: Contact your Jira administrator for configuration issues
  3. Support: Reach out to NewSysRS support for plugin-specific problems
  4. Community: Check Atlassian Community forums for general Jira questions

🚀 Ready to Get Started?

Reviews for Jira transforms your development workflow by bringing structured code reviews directly into your project management process.

What You'll Achieve:

  • Higher Code Quality
  • Better Collaboration
  • Improved Compliance

Contact & Support:

Start with basic configurations and simple workflows, then gradually add automation and advanced features as your team becomes more comfortable with the system.