Run your first deep review

Request a pull-request review and find the results in GitHub and Doomer.

Run your first deep review

Start with a Doomer project that has deep reviews available, the GitHub App installed, and an enabled repository. A project owner or admin can configure repositories.

Request the review

Open a non-draft pull request, push a commit to one, or mark a draft ready for review. With Automatic reviews enabled, Doomer queues a review of that change.

To review a pull request that is already open, comment:

text
/doomer run

A repository owner, organization member, or collaborator can request the review. The repository must be enabled. The command also works when automatic reviews are off, and on drafts. Draft reviews provide feedback without automatic approval or merge.

Installing the App alone does not immediately review existing pull requests. Request one explicitly when checking your setup.

Find the results

  1. Find the Doomer check on the pull request's current commit. It moves from queued to in progress as the review runs.
  2. Read the review comments. Findings on changed lines appear on the diff; other findings appear in the review body.
  3. Open the linked Doomer review page for findings, available intent and sources, and supporting evidence. Sign in with access to the project.

A successful check means the review completed without posted findings. A neutral check can contain findings; it is not a failed review. A failed check means the review did not finish. Read the result before deciding what to do next.

Respond and review again

Investigate findings, explain disagreements in a reply, and make any needed fixes. Push another commit for an automatic review, or use Check states and reruns for explicit commands and check behavior.

Review completion does not itself approve or merge the pull request. Approval and merge are separate settings.

Next steps

Understand review results, connect integrations for requirements and other context, or customize deep reviews to supply your team's review guidance.