Approve or request changes

Approve work or request changes

After you review a notebook, you can approve the work or request that the author make changes. Collaborators in a notebook can manage and respond to reviews and use them to record final decisions. 

Each review that you post includes an overall decision plus any comments you may want to include. Writing commentary with your review is required in order to provide valuable context to the decision-making process. You can also leave comments without posting a decision to discuss the work that’s under review.

Any collaborator can comment in a notebook review. Only added reviewers with a contributor seat can approve or request changes. Viewers can comment in a review but are not able to approve or request changes.

Review a notebook

  1. In the left side navigation, click Notebooks.
    Notebooks_Home.png
  2. Click the name of the notebook you want to review.
    Notebook_Select.png
  3. Read through the contents of the notebook. You may post comments on specific elements of the notebook before submitting your final review.
  4. Near the top of the page, click the review block to open the right sidebar with the review details. Read the review title and description to understand why the requester wants feedback.
    Notebooks_-_Approve_or_request_changes__5_.png
  5. Write a review for the notebook explaining your decision to approve the work or request changes, and include any other overall feedback you have on the notebook.
    Notebooks_-_Approve_or_request_changes_2__3_.png
  6. Click Request Changes or Approve to submit your decision along with any feedback you may have. If you’re not ready to review, you can also click Comment to respond without posting a decision.
    Notebooks_-_Approve_or_request_changes_2__2_.png

Change your review

While the work in a notebook progresses, you can change your review decision as often as needed until the review is marked as finished.

  1. Near the top of the page, click the review block to open the right sidebar with the review details and any previous comments you and others have made.
    Notebooks_-_Approve_or_request_changes_4.png
  2. Use the text field to add any new commentary that you would like to go along with your changed decision.
  3. Click Request Changes or Approve to submit your decision along with any feedback you may have. Your new decision is added to the bottom of the thread and your review status is updated to match your most recent review.
    Notebooks_-_Approve_or_request_changes_5.png