Comment
Key point: Content created by a group member and attached either to a document generally or to a specific location in a document. Comments can also be posted to a group instead of a document.

To understand comments, it helps to know that every group, document and document fragment has a unique identifier that PageSeeder can use as an email address. This means any of these locations can host the same type of threaded discussion people have in normal email environments. The email analogy for comments extends to file attachments, which are linked to the comment and stored in the group under the /attachments folder.

Like email, the content of a comment can be richly formatted with headings, lists and more, plus a separate title.

To make comments easier to search, they can have labels. Members can set their own preferences for how they are notified of new comments by changing the notification settings for each group. Other settings such as whether to send attachments or only include a download link are in personal details.

To assign a comment to someone or attach a status for tracking, the comment can be converted to a task.

In the user interface, PageSeeder uses the or the icons for individual comments, icon for discussions.

As opposed to edit notes, comments are permanently attached to the location until they are archived.

For managers: Managers can change the location of any comment.

Posting comments

There are two ways to post and reply to comments in PageSeeder:

  • Using the user interface, by clicking the appropriate icon to open the comment dialog.
  • By email, using the address corresponding to the intended location.

Group members can also reply directly to the email notification for the comment.

When you reply to an email, most email clients include a copy of the previous email before or after your response. Your response must be before the previous email content so that it is not removed when PageSeeder automatically detects and removes copies of the previous content.

Groups can be configured so that comments can be posted:

  • Only by group members.
  • Or by someone not registered to the group ('the public').

When a group is open to the public, comments are typically moderated. This means they are first routed to a Moderator who can delete the comment, edit or move it, before releasing it to the group.

Comment distribution

All comments are posted in the context of at least one group.

It’s possible to post comments to multiple groups by posting against a shared document. When a comment is posted to multiple groups, it is referred to as a shared comment. See How to post a shared comment.

You can also copy external users – people who aren’t members of PageSeeder – in your comments by including their email address as a recipient or CC of an email to a PageSeeder group. They receive a copy of your original email instead of the email formatted by PageSeeder.

API use

PageSeeder’s API lets developers have more control over the comments than is available through the user interface. Through the API, developers can:

  • Define a custom type.
  • Use a different media type for the contents.
  • Attach specific properties.

These are displayed in the PageSeeder interface, but they can only be edited through the API.