What's New in Review Board

Review Board 6.0.1 fixes a handful of bugs found in the recent 6.0 release:

• Reviews and replies should now successfully publish in all cases.

• Administrators can once again see and edit another user's draft review requests.

• Compatibility issues with subdirectory installs or Local Site partitioning have been resolved.

• Plus other bug fixes throughout the product.

All the details can be found in the release notes.

Asana and Trello integrations updates

We've also released Review Board Integrations 3.1.1, which fixes compatibility with Trello and Asana. This must be upgraded manually for now:

$ pip3 install rbintegrations==3.1.1

This is compatible with both Review Board 5 and 6.

Let's get started!

To learn more about upgrading your server, see our upgrade instructions. You can also use our official Docker images.

If you need assistance with your server, we can help under a support contract.

Review Board 6 is all about focusing on your code review experience in a pleasant environment.

The UI is bright, soft, and colorful. The diffs are easier on the eyes, and easier to navigate. The review process is streamlined, a new review banner guiding you through creating, managing, and publishing your review request, reviews, and replies. Rich commenting is effortless, with Markdown formatting aided by a helpful new toolbar.

And that's just the beginning. Let us introduce you to Review Board 6.

A bright start

We’ve been improving the look and feel of Review Board, softening and brightening the visuals, giving content some breathing room, and sanding down rough edges.

The color palette and font size used in diffs have been refined to make it easier to read long blocks of code.

Much of our UI has been made more accessible and mobile-friendly.

This is the first step toward a larger UI refresh planned for Review Board 7.

Looking for something less bright? Say, a dark mode? That's in the works, but for now, we find Dark Reader to be pretty useful ourselves!

An improved review experience

In past versions of Review Board, your draft review requests, reviews, and replies were all managed separately, each with its own green draft banner.

Review Board 6 now includes a new Unified Review Banner, which summarizes every draft that still needs to be published on a review request.

This banner allows you to:

• See all your drafts in one place
• Publish all your drafts together with fewer e-mails, or publish them independently as before
• Create new reviews on a review request

This banner is always visible on the screen, and will help guide you through the review process.

The old Review, Add Comment, and Ship It! buttons on the review request’s action bar have been moved to a new Review menu on the banner, helping you create, manage, and publish your reviews from anywhere on a review request.

To help get going, we’ve added new tips and tricks to the Review Dialog, shown when clicking Review -> Create a New Review.

And finally, you can review your own diffs and files before they’re published, helping make comments that guide reviewers through your change.

Craft Markdown comments with a click

It’s easier than ever to compose Markdown text for your reviews, comments, and review requests through the new Markdown formatting toolbar.

Toggle between bold, italic, strike-through, and code literals. Create lists, link to URLs, and then go beyond text by uploading and embedding images.

Better file attachment management

File attachments are an important part of many people's workflows. Review Board 6 now makes it easier to track which files are published, which you're introducing in a draft, and which are pending deletion.

When adding, updating, or deleting file attachments, a label is now placed on the thumbnail showing its status:

• New: The file attachment was newly-added in this draft.
• New Revision: A new, updated revision of a file attachment was added in this draft.
• Pending Deletion: The file attachment will be deleted when the draft is published.
• Draft: The file attachment’s caption has been updated in the draft.

If a file attachment is pending deletion, you can now restore it by clicking Undo Delete in the file attachment’s actions menu.

Take action with extensions

Review Board’s extension abilities have grown once again.

The new Actions system makes it easier to add, hide, and reorder actions on the review request’s action bar, on the page header, and the navigation bar.

Client-side extensions can now be written using TypeScript and Spina, and bound together using ES Modules.

Server-side extensions can benefit from enhanced Python type hints and pytest-based unit tests.

Important compatibility updates

We’ve dropped support for Python 3.7 and added 3.12. Please note that not all third-party repository support is compatible yet with 3.12.

We’ve also dropped Subvertpy support. To use Subversion with Review Board, make sure to install PySVN.

Plus…

• Faster automated code review results
• A better default view for dashboards, showing all your incoming and outgoing review requests
• A service health check URL (/health/) for monitoring, scaling, and fault tolerance
• New Single Sign-On options, for wider Identity Provider compatibility
• Enhanced API error reporting, with string-based error types
• Performance and usability improvements all throughout Review Board
• And more!

The Review Board 6 release notes cover all the changes in this release in detail.

Ready to upgrade?

For most users of Review Board 5, Review Board 6 will be a drop-in replacement with minimal downtime.

Still, make sure you have a backup of your database and site directory, and please perform a test upgrade on a test server. Then follow the upgrade instructions.

If you’re using Docker, follow our Docker instructions to deploy new containers. Review Board 6’s official Docker images are based on Ubuntu 22.04 LTS and Python 3.11.

If you need assistance, we can help support your Review Board server with a plan that meets your needs.

Review Board 5.0.6 is a bug fix release, featuring:

• MySQL installation fixes
• Review Group API improvements
• Several bug fixes

Let's take a look.

MySQL Installation Fixes

The recent versions of mysqlclient fail to install on many Linux distributions, and this makes for a frustrating Review Board installation experience.

Now, when installing the ReviewBoard[mysql] package, we now cap this to the 2.1.x series, which installs the same way as prior versions.

You can learn more about this issue on the mysqlclient GitHub, and in our MySQL installation instructions. We'll continue to track development around this issue, and update our documentation and requirements if the situation changes.

Review Group API Improvements

The Review Group API now supports querying for:

• Hidden accessible review groups
• Review groups based on the invite_only flag
• Hidden invite-only review groups when using the special reviews.can_view_invite_only_groups user permission

Plus...

• Improvements for the upgrade process
• Fixes for file attachment diffs
• Fixes for updating file attachments with new revisions
• Showing hidden review groups and repositories for Default Reviewers, integration conditions, and more

All the details can be found in the release notes.

To learn more about upgrading your server, see our upgrade instructions. You can also use our official Docker images.

If you need assistance with your server, we can help under a support contract.

Beta 3 is here, with a more polished Review Board look and feel, a toolbar to help format your Markdown text and attach images, a better experience for the new Review Banner, and numerous fixes and improvements throughout the product.

If you're discovering 6.0 for the first time, look at our announcements for 6.0 beta 1 and 6.0 beta 2 to learn about the new features, like the Review Banner, improved diff navigation, and all the new extension capabilities that can help tailor Review Board for your team.

A more pleasing experience

We’ve refined Review Board’s look, making small adjustments throughout the product to help it feel lighter, with easier-to-read diffs and more apparent controls.

This is the beginnings of a larger effort that we’ll be continuing through Review Board 7 to help modernize the UI and give users more control over how Review Board looks on their system.

Format Markdown and upload images with just a click

We’ve made it easier to work with Markdown text anywhere you see a text field. The new Markdown formatting toolbar helps you format your reviews, comments, and review requests using Markdown.

Toggle between bold, italic, strike-through, and code literals. Create lists, link to URLs, and then go beyond text by uploading and embedding images.

Guiding you to better reviews

We’ve added useful tips and tricks for helping compose your reviews, right at the top of the Review Dialog.

In addition, the new Review Banner is now available any time you see a review request, regardless of whether it’s in draft form, published, or closed. You can also publish all reviews and review requests with one click.

Plus…

• Usability improvements for working with text fields
• Performance improvements for publishing drafts
• New APIs and extension capabilities
• Better repository validation for Git and Subversion
• And lots of bug fixes!

See the release notes for the full list of changes and installation/upgrade instructions.

Next release will be RC1, our release candidate. We’d love to get some more testing, and have a handy Docker image you can try to get started. Your feedback will help us make 6.0 a rock-solid release.

Review Board 6 beta 2 builds upon the new review and extension functionality in Review Board 6 beta 1 to bring better diff navigation, self-review of draft diffs and files, improved SAML support, and even more extension options.

Better Diff Navigation

When viewing diffs, the file you’re currently looking at is now shown in the Review Banner at the top of the page. This helps you keep track of where you are in the review process.

You can also use this to quickly jump to any other file in the diff.

Use the colored dots to get a sense of the inserted, deleted, and replaced sections of the file, and to quickly jump to them.

Self-Review of Drafts

It’s now easier than ever to leave notes on your diffs for others, or to practice effective self-review.

Before publishing your change, you can now comment on your draft diffs and files, helping give other reviewers a heads up about how the code works or what problems you’ve already spotted that they can ignore.

Simply comment like normal, and then click Publish All to publish your draft change and comments all at the same time.

Improved SAML Single Sign-On

Review Board 5 introduced Single Sign-On with SAML, and Review Board 6 is giving you more options to better integrate with your Identity Provider.

Now, administrators can better link up user accounts by configuring the NameID format and user attribute names to match what your Identity Provider expects.

New Extension Features

We’ve added two new extension hooks to help you customize your Review Board and to build new features:

• HideActionHook helps Python extensions hide built-in actions (like “Ship It!”), making it easier to replace them with your own custom actions.
• FileAttachmentThumbnailContainerHook gives JavaScript extensions the ability to add new items to the file attachment thumbnail menu.

We’ve also added support for using pytest to unit test your extensions with rbext test. Simply run rbext test --pytest. This will become the default in Review Board 7.

Plus…

• Multiple tabs/windows showing the same review request will reload when publishing or discarding a review in one.
• We’ve made several usability improvements to the new Review Banner and the Review Dialog.
• We’ve improved API performance across the board with better caching logic.

There’s more in the works for Review Board 6, including better self-signed SSL/TLS certificate management for repositories, LDAP, and Active Directory.

We expect the next beta to be the last. If you’d like to help us test, please reach out with your feedback! You can use the beta 2 Docker image to get you started. Betas are also covered under an active support contract.

See the release notes for the full list of changes.

Review Board 5.0.5 offers improvements and fixes to Single Sign-On, web-based login for the upcoming RBTools 5, improved support for installing with Python Virtual Environments (required in this year's Linux distributions), and more.

Let's dig in.

Improved Single Sign-On

We've fixed a handful of bugs in the Review Board 5's new Single Sign-On support, improving compatibility with most services.

Now, if a page requires you to log in first, you'll be taken back to that page once successfully logged in. Thanks to everyone who let us know this wasn't working right.

Web-Based Login for RBTools 5

RBTools 5 is in development, and includes the ability to log in using the Review Board website. This means you can finally use your standard Single Sign-On authentication for RBTools.

We're hard at work on RBTools 5, and will be shipping it later this year. If you'd like to beta test this, please reach out to support for pre-release builds.

Python Virtual Environments

Python Virtual Environments provide a way to isolate Python applications and services from the system or other Python applications. They help you avoid various forms of installation problems, and they're required in Ubuntu 23.04, Debian Bookworm, and Fedora 39 (with other Linux distros soon to follow).

Starting in 5.0.5, Review Board can now help you install into a Virtual Environment and will automatically make use of it no matter what web server you're using.

We've updated our installation documentation to help you install and use Review Board in either Virtual Environments or in traditional setups.

Please note: If you're not using a Virtual Environment today, you don't need to switch to one unless you're planning to upgrade to this year's Linux distributions.

Plus...

• It's now easier to manage review groups and repositories when configuring an integration, such as Slack or Jenkins.
• New python and pip site management commands for running the correct versions for your environment.
• Compatibility fixes for modern Python packaging support.

All the details can be found in the release notes.

To learn more about upgrading your server, see our upgrade instructions. You can also use our official Docker images.

If you need assistance with your server, we can help under a support contract.

RBTools 4.1 is ready for Review Board 6, and comes with a host of new features improvements for working with Windows and your source code repositories. Including new integrations for Perforce setups.

Ready for Review Board 6

Review Board 6 is coming soon. We've updated RBTools 4.1 to ensure your upgrade to Review Board 6 is as smooth as possible, without dropping support for any prior versions of Review Board.

We recommend that all users upgrade to RBTools 4.1 before you deploy Review Board 6 for the best experience.

SSL Improvements

RBTools 4.1 simplifies SSL management by including up-to-date root SSL certificates, making it effortless to work with newer SSL certificates even on older Python installations.

When SSL issues do occur, you're not left in the dark. A complete description of the problem, along with steps to rectify it, will be displayed. This includes guidance on how to register self-signed certificates with Python, and how to update root certificates. This way, you're empowered to address SSL issues swiftly and effectively.

Enhanced Perforce Integration

RBTools 4.1 provides a new Perforce trigger script to better automate your review process.

With this trigger script, Perforce administrators can ensure that a review request has been reviewed and approved before acceptance. The default is set to a "Ship It!" status with no open issues, and extensions can customize this.

The script will also update the changeset with the URL to the review request and then close the review request upon submission. See the trigger script for instructions, and our guide on using RBTools with Perforce to learn how to use Perforce with Review Board.

A Better Experience on Windows

The Windows installer now bundles GNU Diff, eliminating the need for a separate installation and providing a more streamlined experience. We've also updated to the latest Python 3.10.11 release.

Plus...

• Improved diff generation for ClearCase and VersionVault.
• Fixes for stamping Perforce changes with a review request URL.
• Fixes for API caching issues.

See the release notes for the full list of changes, including changes affecting script authors.

To learn more about RBTools, see the RBTools downloads page and RBTools 4 documentation.

Review Bot 3.2 is a small release focusing on compatibility improvements, Secret Scanning enhancements, and improvements in automated reviews.

What is Review Bot?

Review Bot is an extension to Review Board that adds automated code reviews to your workflow. It integrates with an assortment of third-party code lint, compliance, and security checking tools to help catch problems early.

It's free, open source, and extensible, making it a great addition to your Review Board server.

New in 3.2: Compatibility Improvements

Review Board 5 and 6 compatibility has improved. Some compatibility issues with recent releases of Review Board 5 have been smoothed over, including a crash when browsing the database entries for Review Bot tools.

We've also addressed issues processing results from Shellcheck and PMD.

Secret Scanning

Our support for Secret Scanning has been updated to look for the new enhanced API token format introduced in Review Board 5.

If you're reviewing infrastructure or tools that integrate with Review Board, this will help catch any API tokens you accidentally leave in a file.

Automated Review Improvements

Some tools had a tendency to leave comments spanning entire functions or classes, making it difficult to read some reviews.

Review Bot now caps all comments to 10 lines. When capped, the original line range will be listed in the comment.

That's it for this release!

For complete details on Review Bot 3.2, see the release notes.

To get started, download Review Bot and read the documentation to begin installing and configuring Review Bot.

We recommend our Docker images to help you get going quickly.

Development on Review Bot 4 will begin soon, with new automated code review tools planned. Stay tuned!

Power Pack 5.2 adds new connection options for Cliosoft SOS and improved repository support for VersionVault and ClearCase.

It also offers improved compatibility with Review Board 6 Beta 1.

What is Power Pack?

Power Pack is licensed add-on for Review Board, offering:

• PDF document review and diffing, allowing you to review documents, schematics, designs, contracts, and code all in one place.
• Report generation, giving you insight into code review practices in your organization.
• Advanced server management for scalability, database management, and splitting/merging installs
• Support for enterprise source code management systems, including AWS CodeCommit, Azure DevOps/TFS, Bitbucket Server, Cliosoft SOS, GitHub Enterprise, HCL VersionVault, and IBM Rational ClearCase.

You can try Power Pack free for 60 days or purchase a license for your server.

Let's explore what's new in 5.2.

SSH Connectivity for Cliosoft SOS

With Power Pack 5.2, Review Board can now communicate with Cliosoft SOS source code management servers over SSH. This simplifies setup, allowing you to use an existing licensed user on any remote server.

This is now the preferred method for talking to Cliosoft SOS.

Larger ClearCase/VersionVault Repositories

ClearCase/VersionVault repositories now support up to 48KB worth of VOB OIDs. This lets you connect to very large repositories with thousands of VOBs.

Review Board 6 Compatibility

Power Pack 5.2 is fully compatible with the current beta of Review Board 6 and the upcoming release (due out soon). If you're planning to upgrade to Review Board 6, we recommend preparing by upgrading to Power Pack 5.2.

For the complete list of changes and installation instructions, see the release notes.

We’re excited to announce the first beta of Review Board 6! This is a smaller release focusing on improvements to the review workflow by giving you a new starting point for creating reviews and the ability to bulk-publish drafts of reviews, replies, and review requests.

If you’re new to Review Board, it’s a free, open source, extensible web-based code review and document review tool, helping developers work together to ensure quality code on their projects, whether using Git, Mercurial, Perforce, Subversion, ClearCase, or other current or future source code management tools.

Let’s take a closer look at some of the key changes in this beta.

The New Review Banner

Since the beginning, Review Board has represented drafts of new reviews, replies, or review request changes as a green draft banner at the top of the screen. Each draft had its own banner, and each draft had to be published separately.

We’re now introducing a new unified banner, which shows everything you have in flight on a review request.

From here, you can:

• Start or edit reviews from anywhere on the page (replacing the old “Review” and “Ship It” buttons).
• File general comments pertaining to the review request as a whole (replacing the old “Add Comment” button).
• Switch between drafts, if you want to publish one independently.
• Bulk-publish all reviews, replies, and pending changes on a review request at once, resulting in fewer button clicks and e-mails.

The banner is always present on a review request. You can use the Review menu to create a brand-new blank review, file a general comment, or quickly file a Ship It! review:

There’s more coming. In beta 2, the new banner will show you your active file in a diff and let you jump to other files.

Learn more about the new review banner.

We’re opening this up to extension authors. Soon, extensions will be able to add new information and sections to the banner, giving your organization more control over your review workflow.

Also For Extension Authors

Extension authors also have a few new goodies in this release:

• We’ve reworked our actions framework, which manages the buttons that can be found on a review request, the review banner, and the page header. It’s now easier to add, replace, or remove actions and tailor the product to your needs.
• We’re adding Python Type Hints throughout our codebase, making it easier for your IDE to ensure you’re calling our internal APIs correctly.
• Client-side extensions can now be written in TypeScript and use ES6 modules. Simply declare an index.ts file in your JavaScript bundle, and use that to write any TypeScript code or import from TypeScript modules.
• You can also now use modern ES6 classes for your JavaScript/TypeScript code. We’ve introduced a new library called Spina to help create these, working as a drop-in replacement for the old Backbone.JS.

We’ll have documentation on all this before the final 6.0 is released.

Plus…

• The dashboard now defaults to the “Overview” view, which shows all your incoming and outgoing review requests.
• We’ve changed “Close -> Submitted” to “Close -> Completed,” removing some old and confusing Perforce-centric terminology.
• Numerous behind-the-scenes improvements for improving performance, architecture, and stability.

See the 6.0 beta 1 release notes for the full list of changes.

Want to Help Us Test?

We’d love to have your help! We have installation information in the release notes.

Please make sure you have a dedicated testing server and database. Do not test this beta in production!

You can use the beanbag/reviewboard:6.0b1 Docker image as well. See our Docker instructions for information on setting up an environment.