Commenting on Notes – Sapience Cloud

Overview

Every note in Sapience now carries a comment thread. Anyone who can see the note can open it, read what everyone else has said, and add their own remark — without editing a single word of the note itself.

That last part is the whole point. Comments are for the conversation around a document: a question about a paragraph, an approval, a "this number looks wrong to me". The note stays exactly as its author wrote it, and the discussion lives beside it.

The short version: open a note, click Comments in the panel that floats over it, type in the box at the bottom, and click Post. Everyone who can see that note sees your comment.

Reading Access Is Enough to Comment

This is the rule most people get wrong, so it is worth stating plainly: if you can read a note, you can comment on it. You do not need edit rights.

Somebody shares a strategy document with you read-only. You cannot change a word of it — and you should not be able to. But you can still say "the Q3 figure on page two is stale", and the author sees it. That is the behaviour you would expect from a shared document anywhere else, and it is now what Sapience does.

The reverse also holds. If a note has never been shared with you, you cannot see it, and you cannot comment on it either.

Three Ways to Open the Comments

Where you are	What to click
Viewing a note, looking at its details	The Comments row in the note information panel, showing the count
Viewing a note, anywhere on the page	The blue Comments: N bar at the top of the floating panel
Viewing a note, from the toolbar	Actions > Add comment

All three open the same window. The floating panel is the one you will probably use — it is the same draggable panel that shows a note's table of contents, and it now doubles as the place a conversation announces itself. On a note with no headings at all, the panel appears purely to tell you there are comments.

Writing a Comment

Open the comments on the note.

Type into the Write a comment… box at the bottom.

Click Post.

Your comment appears at the bottom of the list straight away, and everyone else sees it the next time they open that note.

Comments are plain text. Line breaks are kept exactly as you typed them. Formatting marks are shown as you typed them rather than turned into styled text — a comment is a remark, not a document.

The limit is 10,000 characters, which is several pages. A counter appears as you approach it.

Nothing is sent until you click Post. If the post fails — you are offline, or the connection drops — your text stays in the box so you can try again. It is never silently thrown away.

Who Can Delete a Comment

A bin icon appears beside a comment only when you are allowed to remove it. The rule has exactly two branches.

You are…	Can you delete it?
The person who wrote the comment	Yes
The creator of the note the comment is on	Yes, whoever wrote it
Anyone else	No — no bin icon appears

So a note's author can always tidy up the thread on their own document, and everyone can always retract their own remark. Nobody else can delete anything.

Sapience works this out for each comment on the server and tells the app what to show, so the icon you see and the permission you actually have can never drift apart.

What Happens Behind the Scenes

The first time anyone comments on a note, Sapience creates a thread attached to that note. There is exactly one thread per note, and it is created once no matter how many people comment at the same moment.

Each comment is stored inside that thread, in the order it was written.

When you open the comments, Sapience checks whether you can read the note, and grants or refuses on that basis. It never asks whether you can edit it.

The comment count you see is read from the same place the list is, so the number and the thread cannot disagree.

When somebody comments, the number updates for you without a page reload.

Reading a Thread

Comments are shown oldest first, top to bottom, which is how a discussion reads. They are never re-sorted, so the thread always reflects the order things were actually said.

Each comment shows the author's initials, their username, and when it was written. Timing is shown by day — "Today", "Yesterday", "3 days ago" — rather than by the hour.

Very long threads are the one exception to seeing everything. Sapience loads up to a thousand comments at once; past that it says so at the bottom of the list rather than quietly showing you a partial thread.

The count in the note's information panel behaves the same way. A note with more than fifty comments shows 50+, because reading the whole thread just to display an exact number would slow down opening every note you own.

What Comments Are Not (Yet)

Being straight about the edges so nothing surprises you.

Not available today	What to do instead
Editing a comment after posting	Delete it and post a replacement
Replying to a specific comment	Quote the person in your own comment
Reactions or emoji	—
Mentioning someone to notify them	Tell them directly; there are no comment notifications yet
An unread badge or new-comments marker	The count tells you how many there are, not how many are new
Comments on files, tasks or projects	Notes only, for now

None of these are refusals — they are simply not built yet.

Summary

Any note you can read, you can comment on, even when you cannot edit it. Open the thread from the note's information panel, the floating panel, or the Actions menu; type and post. You can delete your own comments, and if the note is yours you can delete anyone's.