DNA: updated from mentions-and-assignments.md

Root ·

Updated from docs/dna/mentions-and-assignments.md in the Knowen repository: How Knowen works is kept with the code.

Changes to the content

# Mentions and assignments

**Mentions.** Write **@handle** in a comment on a node or on a change, or in a Talk topic or reply, and that person gets an **action item**, if they can read the node. Knowen suggests handles as you type. The item says which handle was mentioned; it never reveals that person's other handles.

**Assignments.** On a node's page, **Assignees** lists the people working on it. Type **@handle** and click **Assign**: they get an action item, and from then on hear about changes and comments on that node **and everything under it**, whether they follow it or not. Assigning a graph's top node covers the whole graph. You can assign only people who can read the node. An assignment gives **no rights**: it changes what someone hears about, not what they may do.

**Who assigns.** On a private graph, the people who can edit it. On a public node, its owners; anyone else can only assign themselves, with **Assign me**. Only the owners, and the people they assigned, see who is on a public node. Details and examples: [Who can assign whom](dna:who-can-assign/nodes/29576).

![Assignees on Energy: @mira, the Assign box, and Message](/dna/media/assign.webp?v=72341707)

**Working together after that.** Once you assigned someone, or they assigned you, you can message each other about it (see [Messages](dna:messages/nodes/29560)). Assigning yourself links you to no one.

**Agents.** An agent working with your token reads your mentions and assignments through the API, so assigning yourself a node is a way to hand it a task. Separate agent accounts are **In development**: one will hear only what is aimed at it (its mentions, its assignments and the nodes it is assigned to), and its owner will get a copy of each.

**How it is built.** Mentions are found in the text when it is saved and resolved through handles. An assignment is a record on the node, with the handle the person was assigned as and the handle of who assigned them; it covers the node's descendants when notifications are worked out.

---
⏎
**Read on**
⏎
- [Who can assign whom](/nodes/29576): On a private graph, those who can edit it assign; on a public node its owners do, anyone can assign themselves, and only the owners' team sees the list.
⏎
**Step by step**
⏎
- [Mention or assign someone](/nodes/29559): Bring someone into a discussion with an @handle, or ask them to work on a node by assigning them.⏎
⏎
# Parents

* Working together: talk, messages and notifications

Feedback00

No feedback yet. Say whether this change improves the node.

Sign in to add a new comment.