Comment on a pull request

Workflows3 min read|||

Use comments when you want the author to make a change, explain a decision, or confirm accuracy.

Before you start

  • Open the PR in DraftView.
  • Confirm you have comment permission for that queue item.

Steps

Open the file in the visual surface, then highlight the sentence or block you want to discuss.

State what should change and why. Use concrete language that the author can act on.

Submit your comments from the review toolbar.

DraftView posts your comments to the PR review thread in GitHub.

Comment on deleted content

DraftView shows content that the PR removes as inline deletion blocks in the review surface, including files that the PR deletes entirely.

To object to a deletion:

  1. Find the deletion block at the place where the content was removed.
  2. Select Comment on the block. DraftView quotes the deleted text into your comment so the author sees the full context.
  3. Submit your review. DraftView anchors the comment to the deleted lines in the GitHub diff, so the thread appears on the removed content itself.

Write comments that resolve faster

  • Tie each comment to one issue.
  • Include expected behavior or exact wording when possible.
  • Ask one clear follow-up question if data is missing.

Related pages