TutorialLearn by doing

Give feedback in your first review

In this tutorial, we’re going to open a review we’ve been invited to, mark up an asset, leave written feedback, and complete the review. Clear, specific feedback is the reviewer’s main job, and Review Studio has tools for pointing at exactly what needs to change. By the end, you’ll have completed a review with an annotation, a text edit, a comment for a colleague, and an attached file.

This is part 1 of 3 in the reviewer tutorials. Next: Make your first review decisions.

Prerequisites

To follow this tutorial, you need:

  • An invitation to an active review that contains at least one image asset with some text in it. The easiest way is to ask a colleague to create a review and add you as a reviewer. If your colleague is working through Review and publish your first adaptations, the review they create there works for this tutorial.

  • A small file to attach to a comment, such as a screenshot or a PDF.

You don’t need a Storyteq CMP account to give feedback: people invited by email can open the review from their invitation. If you do have an account, a user role with at least the Reviewer role for Reviews, under Adaptation Studio, also lists the review on your Reviews page. Each role’s permissions are listed in User role presets and permissions.

What we’ll create

We’ll open the review from its invitation email and find our way around Review Studio. Then we’ll add three kinds of feedback to one asset: a drawn annotation, a suggested text change, and a comment that tags the review’s owner, with a file attached. Finally, we’ll complete our part of the review.

The tutorial takes about 15 minutes, including the videos, in six steps:

Step 1: Open the review

Every review starts with an invitation.

Open a review from your invitation (28 s)

We’re going to open the review from the email it sent us.

  1. Open the review invitation in your inbox.

    The email displays the review’s name, its feedback deadline, and the assets it contains.

  2. Select Go to Review.

Review Studio opens in a new browser tab.

If you have a Storyteq CMP account, you can also find the review on the Reviews page: open My Reviews, then select Launch on the review.

Step 2: Find your way around

A review can hold several assets, and Review Studio offers different ways to view them.

Find your way around Review Studio (1 min 5 s)

We’re going to try each view, then settle on the asset we’ll give feedback on.

  1. Check how many assets the review contains. The count is displayed in Review Studio.

  2. Switch between the three view modes:

    • A single asset on its own.

    • A single asset with a strip of thumbnails, for moving between assets.

    • A tile grid showing every asset at once.

  3. Return to the single asset view with the thumbnail strip, and select the asset with text in it.

You’ll notice that Review Studio has three areas:

  • The Tools menu on the left.

  • The asset in the centre.

  • The comments panel on the right, which is empty for now.

Step 3: Mark up the asset

The quickest way to point at a problem is to draw on it.

Mark up an asset (45 s)

We’re going to circle part of the image and say what should change.

  1. In the Tools menu, select a markup tool, such as a shape or freehand pen.

  2. Select the colour icon and choose a colour that stands out against the asset.

  3. Draw around the part of the image you want to comment on.

    A comment field appears as soon as you start drawing.

  4. Enter Can this product shot be brighter?

  5. Select Post.

You’ll notice that:

  • Your comment appears in the comments panel, numbered.

  • Selecting the comment highlights the annotation it belongs to.

Step 4: Suggest a text change

When the asset contains text, you can mark up the words themselves, not only the area around them.

Suggest a text change (53 s)

We’re going to suggest replacing one word in the asset’s text.

  1. Select the text annotation tool, marked T.

  2. Highlight one word in the asset’s text.

  3. In the window that appears, select Paste to copy the highlighted word into your comment.

  4. In the toolbar above the comment, select Replace.

  5. Enter the word you’d like instead, then select Post.

You’ll notice that:

  • The word in the asset is marked up as a replacement.

  • The comments panel lists the suggestion alongside your earlier annotation.

The same toolbar offers strikethrough, to suggest removing text, and underline, to draw attention to it.

Step 5: Comment and attach a file

Not all feedback is about one spot on the asset. General comments cover the asset as a whole, and can bring in other people and supporting files.

Comment and tag a colleague (47 s)

We’re going to leave a general comment that tags the colleague who invited us.

  1. In the comment field at the bottom of the review window, enter @ followed by your colleague’s name.

  2. Select your colleague from the list.

  3. After their name, enter See the attached reference for the colour we’re aiming for.

Before posting, we’ll attach our file.

Attach a file to a comment (23 s)
  1. Select the paperclip icon.

  2. Drag your file into the upload window, or browse for it.

  3. Post the comment.

You’ll notice that:

  • The comment appears in the comments panel with your file attached beneath it.

  • Selecting the attachment opens a preview, from which it can be downloaded.

Tagging your colleague sends them an email, so they know there’s a comment waiting. They can reply to it directly in the review.

Step 6: Complete your review

Your feedback is saved as you post it, but your colleague doesn’t know you’ve finished until you say so.

Complete your review (25 s)
  1. Scroll to the top of the review.

  2. Select Set Status.

  3. Select Confirm.

You’ll notice that you have no further actions in the review. The review’s owner can now read and act on your feedback.

If you were added as a decision maker, you also approve or reject each asset. That’s the next tutorial, Make your first review decisions.

The finished review

Here’s what we’ve left for the review’s owner:

  • An annotation: a drawn markup with the comment Can this product shot be brighter?

  • A text suggestion: one word marked for replacement, with the new word.

  • A general comment: tagging your colleague, with a reference file attached.

  • Your status: review complete.

Conclusion

In this tutorial, you’ve learned how to:

  • Open a review from its invitation.

  • Switch between Review Studio’s view modes.

  • Mark up an asset with an annotation and a comment.

  • Suggest a text change with the text annotation tool.

  • Tag a colleague in a comment and attach a file.

  • Complete your part of a review.

Next, continue with Make your first review decisions to make the final decision on a review’s assets. To review videos, and to review alongside a colleague on a call, continue with Give feedback on your first video. Create and run a review covers the whole review process, from the requester’s side.