# Comments

Comments are for people to talk to each other on a card. The thread is separate from the chat with Andon (⌘J) and from
a run's conversation on the Run tab. Use it to ask a teammate, record a decision, or hand a remark to the card's run.

## Where to find them

- **On a card**: the **Comments** tab in the rail, right after **Notes**, with the number of comments on the tab. On
  the full card page, tabs that don't fit go into the rail's **More** menu.
- **On a phone**: a **Comments** section right after the notes, closed until you open it. A mention's link opens it.

## Write a comment

1. Open the card's **Comments** tab.
2. Type in the box. It is the [notes editor](https://andon-docs.pages.dev/guide/notes.md): Markdown, the `/` block menu, `@` to mention someone, and
   pasted or dropped files, which become the card's attachments.
3. Press ⌘↩ (Ctrl+Enter) to post.

Then:

- **Reply** on a comment, or on any of its replies, to add to that comment's thread. Replies are one level deep.
- **Edit** your own comment from its `…` menu. It is marked *edited*.
- **Delete** your own comment from the same menu. Owners and admins can delete anyone's, and the audit log records
  it. A deleted comment that has replies leaves *This comment was deleted.* in its place.
- Click an emoji under a comment to react, and click it again to take yours back. Each person adds each emoji once.

A `#` link to a card, such as `#ENG-42`, works for the key of the card's linked Linear or Jira issue. A card's own
Andon key, such as `#WEB-12`, doesn't become a link.

## Mention someone

Type `@` and pick a member, or write their handle: their name in lower case, with dots between the words
(`@ada.lovelace`). `@owner` and `@assignee` mention the card's owner.

The person you mention:

- gets one notification for the comment, also when an edit adds them
- sees it in **Activity** under **Mentions**; opening it goes to the comment on its card and marks it read
- gets a push on each device that has **Someone @mentioned you on a card** ticked, titled *Sam mentioned you on
  WEB-12*. Pick that in **Settings → You → Devices**. Quiet hours apply

Only people who can see the card are notified, and never the author. A mention doesn't pulse or appear in Needs you. Mentions aren't sent by email.

## Comments and the run

- **Ask the agent** on a comment sends it, quoted with its author, to the card's run as a reply. It shows only while
  the run can take a reply.
- A run reads the card's latest 20 comments only when its recipe's template asks for them with `{{comments}}`. See
  [Writing a recipe](https://andon-docs.pages.dev/guide/writing-a-recipe.md).
- A run can leave a comment on its own card. It shows as from the machine, with an *agent* tag, and mentions nobody;
  when an agent needs your answer it asks, and that shows in Needs you. The run's history says *Commented on the card*.
  Nobody can edit an agent's comment; an owner or admin can delete it.

## Comments from Linear

A card made from a Linear issue brings the issue's comments, marked *from Linear*. They are read-only on the board.
Their author, or an owner or admin, can still delete one. See [Integrations](https://andon-docs.pages.dev/guide/integrations.md).
