Comments & Discussions

Comments enable collaborative discussions around issues and motions, helping your team share perspectives, ask questions, and build consensus before voting.

The discussion section where team members can share comments

Adding comments

Comment on an issue

1. Open the issue

2. Scroll to the Discussion section

3. Type your comment in the text field

4. Click Post

Comment on a motion

1. Open the issue containing the motion

2. Navigate to the specific motion

3. Add your comment in the motion's discussion area

4. Click Post

Threading

Decisio supports threaded discussions to keep conversations organised.

Threaded comments keep conversations organised

Reply to a comment

1. Find the comment you want to respond to

2. Click Reply

3. Type your response

4. Click Post

Replies appear nested under the original comment, making it easy to follow the conversation flow.

When to use threads

Scenario	Recommendation
Responding to a specific point	Reply to that comment
Asking a clarifying question	Reply to the relevant comment
Introducing a new topic	Start a new top-level comment
Providing general feedback	Start a new top-level comment

Formatting

Comments support rich text formatting:

• Bold and italic text

• Bullet points and numbered lists

• Links to external resources

• Code snippets for technical discussions

Use formatting sparingly to maintain readability. Clear, concise comments are more effective than heavily formatted ones.

Editing comments

You can edit your own comments after posting:

1. Find your comment

2. Click the Edit button (pencil icon)

3. Make your changes

4. Click Save

Edit history

Edited comments show an "edited" indicator. The original content is preserved in the audit trail for transparency.

Deleting comments

To remove a comment you've posted:

1. Find your comment

2. Click the Delete button (trash icon)

3. Confirm the deletion

Deleted comments are removed from view but may be retained in the audit trail for compliance purposes.

@Mentions

Bring specific team members into the conversation by mentioning them directly in your comments.

How to mention someone

1. Type @ in your comment

2. Start typing the person's name

3. Select their name from the dropdown

4. Continue writing your comment

When you mention someone:

• They receive an email notification

• The mention appears highlighted in the comment

• The item appears in their Action Items on the dashboard

You can only mention members of the workspace who have access to the issue.

When to use mentions

Scenario	Example
Request input	"@Jane, what's your view on Option A?"
Assign a task	"@Mike, could you review the attached report?"
Alert relevant people	"@Legal Team, this affects the contract terms"
Get expert opinion	"@Finance, is this within budget?"

Notifications

Stay informed about discussions relevant to you:

• New comments on issues you created or are following

• Replies to your comments

• @Mentions when someone specifically tags you (with email notification)

Manage notification preferences

1. Go to Settings > Notifications

2. Configure your comment notification preferences

3. Click Save

Best practices

Writing effective comments

Do	Don't
Be specific and constructive	Leave vague feedback
Reference relevant exhibits	Make claims without evidence
Ask clarifying questions	Assume everyone has the same context
Stay focused on the decision	Introduce unrelated topics

Facilitating productive discussions

As an issue owner or moderator:

• Summarise key points periodically in longer discussions

• Acknowledge contributions to encourage participation

• Redirect off-topic conversations to appropriate venues

• Highlight important comments that inform the decision

Timing discussions

• Start discussions early to allow thorough consideration

• Set clear timelines for when input is needed

• Summarise discussion points before voting begins

• Close discussions gracefully when voting concludes

Discussion and voting

Comments help inform decisions, but votes are separate:

1. Discuss - Share perspectives and ask questions

2. Deliberate - Consider all viewpoints

3. Decide - Cast your vote based on the full discussion

Encourage team members to participate in discussions before voting. Well-informed votes lead to better decisions.

Related

• Issues - The primary location for discussions

• Motions - Discuss specific proposals

• Voting - How decisions are formalised