Developer docs

Reviewing and publishing a proposal

Tabs, inline comments, the review brief, reviewers, verdicts and Publish.

Steps

  1. Four views

    Edit the text, see the Changes against Current, Preview the result and discuss it in Conversation.

  2. Comment inline

    In Preview, select text to comment on it. Resolve the thread once it is handled.

  3. Review brief

    An AI summary of where the review stands: open threads, verdicts and what is left. It is advice, never an approval.

  4. Reviewers

    Add the people who must review. Each one is notified and gives a verdict.

  5. Your verdict

    As a reviewer, approve or request changes here, with an optional note.

  6. Publish

    Publishing makes this proposal the new Current version. Review rules can require approvals first.

Take the tour in the app

In the app, open the ? menu at the bottom of the sidebar and choose Take the tour of this page, or start any tour from Settings → Personal → Guides and tours.

All guides: Guides.