Comments

Share feedback, ask questions, or clarify details on bugs and stories.

Comments let your team discuss a story, bug, or epic right where the work is described. You can comment on the item as a whole or on specific text, mention teammates to bring them into the conversation, and accept or reject comments as the feedback is addressed, so the discussion and its outcome stay connected to the work.



Add a comment

You can add comments to stories, bugs, and epics, either to the item as a whole or to specific text in it. Each comment can be up to 2,000 characters. If a comment is longer, the send icon is disabled until you shorten it.


Add a general comment

General comments aren't tied to specific text, which makes them useful for broader feedback or questions about the item as a whole.

  1. Open the story, bug, or epic.
  2. In the header, click Add comment, or the comment icon if the item already has open comments.
    • The Comments panel opens, with the comment box at the bottom.
  3. Type or paste your comment.
  4. Click the send (paper airplane) icon or press Enter to add your comment.

Comment on specific text

For more detailed feedback, you can comment directly on selected text in a story, bug, or epic.

  1. Highlight the text you want to comment on.
  2. In the toolbar that appears, click Comment.
  3. In the popup, type or paste your comment.
  4. Click the send (paper airplane) icon or press Enter to add your comment, or click X to cancel.

Comment on an AC

On stories, you can also comment on a specific acceptance criterion (AC), so the feedback stays tied to the exact requirement you're discussing.

  1. Hover over the AC you want to comment on.
  2. Click the ellipsis (...) icon that appears and select Add comment.
  3. Type or paste your comment.
  4. Click the send (paper airplane) icon or press Enter to add your comment, or click X to cancel.

Mention a user in a comment

You can mention other users in a comment to bring them into the conversation. While writing a comment, type @ and select a user from the list that appears.

When you mention a user, Atono sends them an email notification with a link to the item. If the mentioned user doesn't have permission to view the item, the notification includes the comment text with limited item details. To reduce noise, Atono may group related @mention notifications sent within a short period into a single email that links directly to the discussion.

If you add a new mention while editing a comment, the newly mentioned user is notified the same way they would be for a new comment.

To type a plain @ symbol, press Esc to close the list and continue typing.


Link to stories, bugs, or epics

If a comment includes the Item ID of a story, bug, or epic (for example, STORY-123, BUG-456, or EPIC-789) or the item's full URL from your workspace, it's turned into a link when the comment is saved. The link shows only the Item ID, and hovering over it shows the item's details. Private and deleted items aren't turned into links.



View comments

When an item has open comments, the header shows the comment icon with the number of open comments in place of 'Add comment'. Click the icon to open the Comments panel.

Open comments are comments that haven't been accepted or rejected. Once a comment is accepted or rejected, it's removed from the Comments panel and from the open comment count, and you can find it in the item's Activities list.

While the Comments panel is open, text with associated comments is highlighted in the body of the item. Click highlighted text to open or focus its comment in the panel.

Comments on specific text are listed in the order the text appears in the item, followed by general comments. If several comments refer to the same text, the newest comment appears first.



Manage comments

The accept and reject icons appear when you hover over a comment in the Comments panel, and the other actions are in the comment's ellipsis (...) menu.


Accept a comment

Accept a comment to show agreement with feedback, confirm a clarification, or acknowledge that a question has been answered.

  1. In the Comments panel, hover over the comment you want to accept.
  2. Click the Accept (check mark) icon.

The comment is removed from the Comments panel and recorded as accepted in the Activities list, along with who accepted it.


Reject a comment

Reject a comment if the feedback doesn't apply, the issue has already been resolved, or the suggestion isn't feasible.

  1. In the Comments panel, hover over the comment you want to reject.
  2. Click the Reject (slashed circle) icon.

The comment is removed from the Comments panel and recorded as rejected in the Activities list, along with who rejected it.


Copy a comment URL

Copy a link to a specific comment to share it with your teammates. Opening the link takes them directly to the comment and highlights it in the Comments panel.

  1. In the Comments panel, hover over the comment.
  2. Click the ellipsis (...) icon and select Copy URL.

Edit a comment

Only the comment's author, Workspace Owners, and Administrators can edit a comment.

  1. In the Comments panel, hover over the comment you want to edit.
  2. Click the ellipsis (...) icon and select Edit.
  3. Make your changes, then click Save, or click Cancel to discard them.

The Activities list shows both the original and edited versions of the comment, along with the time of the edit. If a Workspace Owner or Administrator edits someone else's comment, the comment stays attributed to its original author, and the activity entry shows who made the change.


Delete a comment

Only the comment's author, Workspace Owners, and Administrators can delete a comment. Comments are deleted right away, without a confirmation step.

  1. In the Comments panel, hover over the comment you want to delete.
  2. Click the ellipsis (...) icon and select Delete.

The comment is removed from the Comments panel, but the Activities list keeps a record of the deletion, including the comment's content and who deleted it.



Comment activity

Atono records comment activity in the item's Activities list, including when comments are added, edited, accepted, rejected, or deleted. To show only comment activity, filter the Activities list by the 'Comment' type.

For more details, see Filter by type.



Did this page help you?