> ## Documentation Index
> Fetch the complete documentation index at: https://vlyai-1c28d863.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Comments and reviews

> Inline comments on code or pages. Review workflows for branches and prompts. Async feedback without interrupting.

For async coordination, use comments. Drop a comment on any line of code, any UI element, or any prompt result; teammates get notified and can reply.

## Where you can comment

<CardGroup cols={2}>
  <Card title="Code" icon="code">
    Click the gutter next to any line in Code mode → Add comment.
  </Card>

  <Card title="UI elements" icon="mouse-pointer-2">
    In visual edit mode, right-click an element → Comment. Anchored to that element.
  </Card>

  <Card title="Prompts" icon="message-square-code">
    Reply to any prompt in the chat sidebar. Threads stay attached to the revision.
  </Card>

  <Card title="Revisions" icon="git-commit">
    Comment on a revision in [version history](/building/version-history). Useful for "this is the cause of the bug" or "good baseline".
  </Card>
</CardGroup>

## Notifications

When someone @-mentions you (`@alice`) or replies to your comment, you get notified:

* In-app notification (bell icon).
* Email (configurable).
* Slack DM if the [Slack integration](/integrations/slack) is connected.

## Resolving comments

When the issue's addressed, click "Resolve" on the comment. Resolved comments collapse but stay searchable.

## Review workflow for branches

For team workflows where main is protected:

<Steps>
  <Step title="Work on a branch">
    [Branch](/building/branching) from main, build the feature.
  </Step>

  <Step title="Open a pull request">
    Branches → \[your branch] → Open PR. The PR shows the diff, the prompts, and the agents used.
  </Step>

  <Step title="Reviewers comment">
    Inline on code, on the prompt log, or on the high-level summary.
  </Step>

  <Step title="Address feedback">
    Either re-prompt on the branch or hand-edit. Each change appears in the PR.
  </Step>

  <Step title="Merge when approved">
    The PR squashes into a single revision on main with the PR title as the revision label.
  </Step>
</Steps>

## GitHub PR sync

If [GitHub is connected](/integrations/github), vly PRs map 1:1 to GitHub PRs. Comments sync both directions; reviews sync; merge in either place.

## Related

<CardGroup cols={3}>
  <Card title="Branching" icon="git-branch" href="/building/branching">
    The unit of review.
  </Card>

  <Card title="Real-time collaboration" icon="users-round" href="/building/real-time-collaboration">
    For sync coordination.
  </Card>

  <Card title="GitHub integration" icon="github" href="/integrations/github">
    PR sync.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.