Configure how reviews are created

As an administrator or space owner, you can set the options for creating reviews in a product/Git repository or a particular stream/branch.

For details on how to set pull request options, see Configure how pull requests are created.

Define review settings in a product

Review settings defined for a product or Git repository apply to all branches in the product.

To configure review settings for a product or Git repository:

  1. On the top navigation bar, select a space from the spaces list.

  2. On the Products page, open a product or Git repository.

  3. On the sidebar, select Settings > Reviewing Changes.

  4. In the Reviews section, define the following review settings:

    Setting Description
    Creating

    Enable or disable the creation of reviews. When reviews are enabled, you can select to create reviews automatically, including pull request merges.

    Check Lists

    Select Enable check list to set the default check list for reviews. Then select the check list to use for new reviews. For details about creating check lists, see Create review check lists.

    Rules 

    Select Use custom review rules to apply a rule to reviews. Then select one of the rules.

    Rules control how reviews move from one state to another, for example, whether all reviewers must approve a review, or just one reviewer. For details, see Review rules.

  5. Click Save.

Back to top

Define review settings in a stream/branch

By default, streams and branches inherit the review settings from their product or Git repository. But you can change the settings for a selected stream/branch.

To configure review settings for a stream/branch:

  1. On the top navigation bar, select a space from the spaces list.

  2. Open a product or Git repository from the product list, and then open the relevant stream/branch.

  3. On the sidebar, select Settings > Reviewing Changes.

  4. In the Reviews section, define the following review settings to override the settings inherited from the product:

    Setting Description
    Creating

    Override product options for creating reviews, such as creating reviews automatically, including pull request merges.

    Check Lists

    Override product defaults for review check lists. For details, see Create review check lists.

    Rules 

    Specify the custom review rules to use for this stream/branch.

    Rules control how reviews move from one state to another, for example, whether all reviewers must approve a review, or just one reviewer. For details, see Review rules.

  5. Click Save.

Back to top

See also: