Conversations mental model
Defining the user stories and the mental model

US1: As an admin, I want to decide if my space allows conversations or not, so that I can control the tone and purpose of my space.

US2: As a new user on a space that allows conversations, I want to understand that I can participate and how, so I feel invited into the community.

US3: As a new user, I want a frictionless way to leave my first comment, so I feel engaged.

US4: As a writer, I want to browse my threads so I can have context of the conversations happening around my content.

US5: As a writer, I want to see a thread anchored to its original text in the document, so I understand what's being discussed.

US6: As a user, I want to save a conversation, so that I can recover the information when I need.

The problem: The current solution has a tab system that hides conversations behind multiple clicks, the Discussions panel opens as a sidebar that competes with the document and threads are difficult to follow.
2 main moments:
Discovering how
Doing it easily and feeling confident

Create comments ✅

✅ As a Member, I want to leave comments on specific words or entire text blocks

As a User, I want to leave comments on specific words or entire text blocks so that community feedback is precise, contextual, and easy to act on.

Context and UI for reply/thread

Reading problem: threaded conversations are hard to follow

⛔️ Context to comment reply / thread

Keep anchor ⚠️

Keep anchor when replying a comment

I believe this is someting we can fix easily? Keep scroll on reply context. Now is going to the top making me scroll again. I can write a US for this. cc Notes about this interaction

Support fragment comments ⛔️

Support fragment comments

Description Allow comments on specific fragments (text selections, blocks, or elements). There is a comment icon right now, but it doesnt embed the actual fragment, and the text is not correctly highlighted.

Conversations mental model Defining the user stories and the mental model

Create comments ✅

Context and UI for reply/thread

Keep anchor ⚠️

Support fragment comments ⛔️

Have a search on comments to find comments

Conversations mental model
Defining the user stories and the mental model