manager-ui
manager-ui copied to clipboard
Content: Comments
Intro
Users will now be able to add comments to individual fields of a Content Item. This will help organizations collaborate better and have faster content workflows and conversations about updates to make to content items.
Feature Set
In the initial version of the commenting system users will be able to:
-
Create a Comment.
- The comments should allow: Hyperlinks, Bold, Italics, Mentions
- The database should support rich text content (for the future). In the future we may want to allow users to: Underline, Add Images
- When a comment is created we want to notify via email:
-
Delete a Comment
- If the user deletes a comment, the replies to it are also deleted
-
Resolve a Comment
- Resolved comments will still be visible in the system. They will only not be highlighted in orange as they have been resolved.
-
Reply to a Comment in a Comment Thread
- Similar to Slack/Google Docs comment threads.
- There is no multi level nested replies.
-
When a reply is created, we want to notify via email
- Anyone who has participated and joined the comment thread
- The creator
- Anyone who has replied after
- Anyone who has participated and joined the comment thread
-
Mention a User in a Comment or a Reply
- The user who is mentioned in the comment will receive an email about the same
- Only a user who has access to the instance can be mentioned and will receive the email. They will only not be able to view the item if they do not have access to it and will see that in the UI. They can then reach out to their admin and request access.
-
Edit a Comment or a Reply
- This includes adding/removing mentions and text content
- There is no expectation that a notification email is sent when an edit is made
-
View a Comment on a Field
- They should be able to see how many replies are present on the item
- View all Comments in a Global Comment Hub
- Copy a link to a Comment Thread which they can share on a 3rd party platform like Slack
-
Receive an Email that they were mentioned in a comment or a reply
- We can show the comment text and the resource details and put a link to resource.
-
Receive an Email that a content item they created has a new comment on it
- We can show the comment text and the resource details and put a link to resource.
Final PRD
https://doc.clickup.com/20654803/d/h/kpapk-1171/79ff855ae886938/kpapk-15671
Figma
https://www.figma.com/file/6TyAXXvHmF3zunsmUn8Ji1/Comments?type=design&node-id=0%3A1&mode=dev&t=wYOethvZkHe5wEPJ-1
@ardeay @zcolah @shrunyan Initial backend tech spec for the commenting system: https://docs.google.com/document/d/19oGzo231ciOdYrLllSOcTpAlDtfbZnt8eJjrqQUlLRs/edit?usp=sharing