Skip to main content
Reviews bring a pull-request-style approval flow to your specs. Reviews are tied to a specific version of the document — reviewers see exactly which version you want feedback on.

​
Request a review

Request a review once the planspace has a prototype and at least one round of comment-driven iteration.
  1. Navigate to the version you want reviewed
  2. Click Request review in the top bar or sidebar
  3. Select one or more reviewers from the planspace members
  4. Add an optional message explaining what you’d like feedback on
  5. Submit the request
Reviewers receive a notification in their For You inbox with a direct link to the version.

​
Submit a review decision

  1. Open the planspace from the notification or your Reviews tab in For You
  2. Read the document version and any comments
  3. Click Approve or Request changes
  4. Add a comment with your feedback
  5. Submit your decision

​
Review states

StatusMeaning
OpenReview is pending — waiting for reviewer decisions
ApprovedAll reviewers have approved
Changes requestedOne or more reviewers requested changes
ClosedAuthor closed the review (superseded or no longer needed)

​
Reviews and Scott CI

When a review is approved, that version becomes the trusted reference point. Scott CI links pull requests back to the approved version, confirming that the implementation matches the signed-off intent.