Ascend Documentation

Appearance

Block Comments ​

This guide explains how to use comments on page blocks to collaborate with your team.

Overview ​

Comments in Ascend are attached to specific blocks (paragraphs, headings, lists, etc.) on a page. This allows for contextual discussions right where they're relevant.

Adding a Comment ​

  1. Hover over any block on a page
  2. Click the comment icon (💬) that appears
  3. Type your comment in the text area
  4. Click Post to add your comment

@Mentioning People ​

You can notify specific people or groups by mentioning them:

  1. Type @ in your comment
  2. A list of team members and groups will appear
  3. Start typing to filter the list
  4. Click on a name to insert the mention
  5. The mentioned person will be notified (when notifications are enabled)

Who Can You Mention? ​

You can only mention:

  • Team members who have access to the page
  • Access groups (all members of the group will be notified)

People without access to the page won't appear in the suggestions.

Replying to Comments ​

  1. Click Reply under any comment
  2. Type your reply
  3. Click Reply to post

Replies are nested under the original comment to keep the conversation organized.

Editing Comments ​

You can edit your own comments:

  1. Click the pencil icon (✏️) on your comment
  2. Make your changes
  3. Click Save

Deleting Comments ​

To delete a comment:

  1. Click the trash icon (🗑️) on the comment
  2. The comment will be removed

Note: Page editors can delete any comment. Regular commenters can only delete their own.

Resolving Discussions ​

When a discussion is complete:

  1. Click Resolve on the top-level comment
  2. The thread will be marked as resolved and collapsed
  3. Resolved threads are hidden by default

Viewing Resolved Threads ​

  1. Look for "Show resolved (n)" link in the comments panel
  2. Click to show all resolved threads
  3. Click "Hide resolved" to hide them again

Reopening a Thread ​

If more discussion is needed:

  1. Show resolved threads
  2. Find the thread you want to reopen
  3. Click Reopen
  4. The thread will become active again

Comment Permissions ​

Who Can Comment? ​

  • Users with Comment or Edit access can add comments
  • Users with View access can only read comments

Who Can Delete? ​

  • You can always delete your own comments
  • Page editors can delete any comment
  • Page admins can delete any comment

Who Can Resolve? ​

  • Anyone with comment access can resolve/reopen threads

Best Practices ​

Keep Comments Focused ​

Each comment thread should focus on one topic. Start a new thread for unrelated discussions.

Use Mentions Wisely ​

Only @mention people when you need their attention. Avoid over-mentioning to reduce notification fatigue.

Resolve When Done ​

Mark threads as resolved when the discussion is complete. This keeps the active comments relevant.

Be Constructive ​

Comments are for collaboration. Keep feedback constructive and actionable.

Frequently Asked Questions ​

Can I edit someone else's comment? ​

No, you can only edit your own comments. You can reply to add clarifications.

What happens when I delete a comment with replies? ​

The comment and all its replies are deleted.

Can I see who mentioned me? ​

When notifications are enabled, you'll receive a notification when someone mentions you. You can also search for your mentions in the inbox.

Not currently. Comments are associated with specific blocks and pages.

What if someone loses access to a page? ​

They can no longer see or interact with comments on that page. Their existing comments remain visible to others.