DNA: started from mentions-and-assignments.md

Root ·

Started 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).
⏎
![Assignees on Energy: @mira, the Assign box, and Message](media/assign.webp)
⏎
**Working together after that.** Once you assigned someone, or they assigned you, you can message each other about it (see [Messages](dna:messages)). 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.
⏎
# 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.