Comments

Discussion on an issue, linking Vault pages from a comment, and why comments are part of what a reviewer receives. Mentions are planned, not built.

Available Updated 2026-11-02

Every issue has a comment thread. Posted comments synchronize to permitted teammates when connectivity and delivery allow; there is no fixed delivery-time guarantee.

Comments are plain text. ⌘/Ctrl + Enter posts. Link Vault page inserts a reference to a page in the active team; the thread shows the page’s title when it can resolve the page, and the reference contributes to the issue’s context bundle.

Mentions are not built

There is no @mention feature. Typing @ inserts the character; there is no teammate picker, and a comment does not record who it is directed at. Writing someone’s name does not reach them. Tell them another way if it is time-sensitive.

Planned: mentions

Mentions need a teammate picker, a stored reference to the person and a notification to deliver it. None of these exist yet. In-app notifications for assignments, comments on your issues, approvals and unblocked work are work in progress; they will not cover mentions until mentions themselves exist.

Comments load on demand

Comments are fetched when you open an issue rather than downloaded with everything else. The first open of an issue may show the thread a beat after the rest of the page; loaded comments can then be read from the local replica.

An issue’s unloaded comments remain unavailable offline until they can be fetched. Core issue fields already in the local replica remain readable; server-only material such as linked Vault page bodies still needs a connection.

Comments are review material

A comment thread is usually where the parts of a decision that never made it into the description live — the constraint someone raised, the question nobody answered, the “let’s leave that for later” that was never written down anywhere else.

This is why comments are pulled into an issue’s context bundle rather than being treated as chat. It is also why the bundle marks truncation in place: a bundle is bounded, and a dropped comment that the reviewer does not know was dropped is worse than one they can see was cut.

If something in a thread is a decision the team will need again, promote it to a Vault page or into the issue’s Intent. Threads are searched less often than you expect.

Editing and deleting

You can edit and delete your own comments. Edits replace the text; there is no per-comment revision history. If it matters that a statement existed, quote it rather than editing it away.

Something here wrong, missing or out of date? Tell us at support@orneos.com — corrections to these pages are welcome and we would rather hear it than have you work around it.