Skip to main content
Comments let teammates discuss exact parts of a planspace document without derailing the main authoring chat. They are best for questions, objections, missing context, and small changes that should be resolved before a review.

​
Create a comment

  1. Open a planspace document
  2. Select the text you want to discuss
  3. Click the comment action
  4. Write the comment and submit
Comments appear in the document margin and keep the conversation anchored to the text that prompted it.

​
Mention teammates

Type @ in a comment to mention a teammate. Mentioned users receive a notification in For You. Use mentions when:
  • a PM needs to clarify product intent
  • a designer needs to check UX assumptions
  • an engineer needs to verify architecture or migration details
  • a reviewer should look at one specific risk

​
Add comments back to chat

Authors can add important comments to the planspace chat so Scott can revise the document with the feedback in context. This is the main loop:
  1. teammates leave comments on the document
  2. the author adds important comments to chat
  3. Scott revises the proposal
  4. the team reviews the updated version

​
Resolve comments

Resolve a comment when the discussion is settled or incorporated. Resolved comments stay attached to the document history so the reasoning remains available later.

​
Comments vs reviews

Use comments while the design is still moving. Use reviews when the plan is ready for approval.