Editor Plugins

Integrations

Team code reviews

Code reviews add a layer of accountability for scrupulous teams and work similarly to pull requests for GitHub.

How code reviews work

When team code reviews are enabled, any new snippets are subject to review and approval by another member of the team. In addition, if snippet update reviews are enabled, updates will also be subject to review and approval by another member.

A typical workflow for creating a new team snippet with code reviews enabled:

  1. Joe creates a new draft snippet and assigns it to Mary.
  2. Mary reviews the draft and asks for code changes via comments.
  3. Joe reviews Mary's comments and makes the necessary changes.
  4. Mary approves the draft, which then becomes a snippet in the team library.

Enabling code reviews

When creating a team

View our guide on creating a team to view steps on enabling code reviews.

For an existing team

Enabling code reviews
  1. Click on the settings button next to the team title in the left-hand sidebar to open up Team Settings.
  2. Select Code Reviews in the navigation menu.
  3. Toggle on the Enable code reviews option.
  4. Optionally turn on Review snippet updates if you'd like edits to also receive code reviews.
  5. Click Save Settings to enable code reviews for the team.

Code review UI

Composing or editing a snippet

With code reviews enabled, the editing snippet dialog will have a control in the footer to assign the snippet draft to another team member.

Editing snippet footer
notes Note: This control will only appear if you have more than 1 other member (besides yourself) on the team.

Code review controls

Snippet code review controls

If you are assigned to review a draft snippet, you have the option to comment or approve the code. You will see the these controls in the snippet view's header.

Sidebar navigation

Sidebar code reviews

Once the draft snippet has been created, it will appear as an item in the sidebar under My Drafts. The navigation items work as follows:

On this page