ARK

Conversations & Threads

Conversations are per-page discussions in Ink. Inline comments attach to a specific block; top-level threads live in the page's side panel. Both support @-mentions, reactions, and resolution.

Inline comments

Select any block (or range within a block) → Cmd+Shift+M or click the speech-bubble icon in the floating toolbar.

A comment is anchored to:

  • The block (if you commented without a selection)
  • A text range (if you had a selection)

Replies thread under the original comment.

Side-panel threads

Open the Conversations panel on the right (press C). This panel lists:

  • Every open comment on the page, in block order
  • Every resolved comment (collapsed by default)
  • A "New thread" button for discussions not tied to a block

Side-panel threads are useful for discussing a whole page rather than a specific line.

Replies and reactions

  • Reply: type in the thread, Enter to send.
  • React: hover a comment → emoji icon.
  • Edit or delete your own comment: menu on the comment.

@-mentions

@username inside any comment:

  • Notifies the user (in-app + email if Resend is configured).
  • Grants them read access to the page if they didn't already have it (admin-overridable setting).

Resolving threads

Mark a thread resolved from its menu. Resolved threads collapse in the Conversations panel. They remain retrievable — "Show resolved" toggles them back.

Page owners and admins can reopen resolved threads.

Mentions of pages and blocks

Inside a comment, @page-name links to another page; #block-id links to a specific block on the current page (right-click a block → Copy block link).

Notifications

Default rules:

  • You're notified about replies in threads you participated in.
  • You're notified about @-mentions.
  • Page owners get notified on new top-level threads on their pages (toggleable per page).

Tune under Account → Notifications → Ink.

Permissions

  • Commenter role or higher can comment.
  • Viewer role cannot comment (only read).
  • Resolving requires Editor or higher.

Version history interaction

Restoring a prior page version does not delete comments. Comments anchored to blocks that no longer exist display as "Orphaned" at the top of the Conversations panel.

Resolved-comment retention

Resolved comments are kept by default. If you want automatic cleanup, admins can configure retention under Settings → Comments → Retention (e.g., "delete resolved comments after 90 days").

Data model

Comments live in comments; threaded replies via parent_id. Anchors in comment_anchors (block id + optional text range). See Database Reference.