Comment features

P4 Code Review comments support a range of collaboration features that help users review code, discuss changes, share information, and track review feedback.

Use the following topics to learn more about the available comment features.

Feature Description

AI Assistant for comments

Use AI-generated suggestions to improve comment text, fix spelling and grammar, or summarize content before posting a comment.

Comment attachments

Attach files and images to comments to provide additional context and supporting information.

Comment mentions

Reference users and groups in comments using @user and @@group mentions.

Comment threading

Reply to comments and participate in threaded discussions.

Comment tasks

Flag comments as tasks to track issues that need to be addressed during a review.

Manage comments

Mark comments as read or unread, archive comments, and restore archived comments.

Markdown in comments and review descriptions

Format comments using supported Markdown syntax.

Share comments

You can create direct links to comments and replies in a review. Sharing a direct link makes it easier for other users to locate a specific discussion without searching through the review.

To copy a link to a comment or reply:

  1. Open a review and locate the comment or reply.

  2. Click the Link icon in the comment action bar. The direct link is copied to your clipboard.

  3. Paste the link into an email, chat message, ticket, or other document.

When a user opens the link, P4 Code Review navigates directly to the selected comment or reply and highlights it.

Direct links can be created for:

  • Review comments

  • File comments

  • Line comments

  • Comment replies

Comment links are supported in Default View only.

React to comments

You can react to comments using emojis. For a list of supported emojis, see the Emoji Cheat Sheet.

To add a reaction:

  1. Click the emoji icon beneath the comment.

  2. Select an emoji.

A notification is sent to the author of the comment when a reaction is added.

To use the same reaction as another user, click the existing emoji attached to the comment.

To remove a reaction, click the emoji again.

Links in comments

URLs included in comments are automatically converted into links.

If a link points to an image or a YouTube video, the content is displayed at the end of the comment.

For information about linking images and videos, see Common text styles.

Comment context

When comments are added to modified lines in a review, P4 Code Review records several lines of surrounding context. This helps preserve the meaning of comments if later revisions change or remove the original lines.

Each comment stores its own context information, but only the first comment on a line displays the captured context.

Checklists

If checklists are available for a review, you can update the status of a checklist item when posting a comment.

If no checklists are applied to the review, checklist options are not displayed.

To update a checklist item using a comment:

  1. Open the Comments tab.

  2. Enter your comment.

  3. Select a checklist item from the drop-down list beneath the comment field.

  4. Select a status for the checklist item.

  5. Click Add.

A tag is added to the comment to show the associated checklist item.

If you select a status that blocks approval, such as Fail or Error, a blocking notification is displayed on the review and the review cannot be approved until the issue is resolved. To learn more about checklists and blocking statuses, see Checklist item status