ViewArticle

[Collapse]Collaborator 11
 [Expand]General Information/viewarticle/91173/
 [Collapse]Getting Started/viewarticle/91524/
   Getting Started For System Administrators/viewarticle/91512/
  [Collapse]Getting Started For Developers/viewarticle/91569/
    Creating Reviews/viewarticle/91566/
    Participating in Reviews/viewarticle/91567/
    Reworking Defects/viewarticle/91568/
 [Expand]Collaborator Server/viewarticle/91192/
 [Expand]Web Client/viewarticle/91304/
 [Expand]Desktop Clients/viewarticle/91320/
 [Expand]Version Control Integrations/viewarticle/91181/
 [Expand]Repository Hosting Service Integrations/viewarticle/91708/
 [Expand]Issue-Tracking Integrations/viewarticle/91689/
 [Expand]External Integrations/viewarticle/91505/
 [Expand]Techniques & Best Practices/viewarticle/91575/
 [Expand]Appendices/viewarticle/91254/
Updated: 5/21/2018 Applies To: Collaborator 11 Rating: No votes Click to rate: PoorNot badAverageGoodExcellent

Getting Started > Getting Started For Developers

Top |Previous |Next

Participating in Reviews

When someone invites you to a review, you receive an email notification. To take part in this review you need to open Collaborator Web Client.

1. Log into the Web Client

Start your favorite web browser and navigate to Collaborator Web Client URL. If asked, enter your user name and password in the login screen.

In the Action items list on the Home screen, you will see a new incoming review.

gs-dev-actionitems

2. Open Review Summary screen

Click the review in the Action items list to open it in the Review Summary screen where you can see the details about this review.

gs-dev-review-summary

Notice that you are the active participant of this review and the review is in the Inspection phase.

3. Inspect review materials

Scroll to the Review Materials section (or click Materials in the toolbar) and click the uploaded file (or the first of several uploaded files). The Diff Viewer will open.

Diff Viewer displays the contents of the chosen file and allows to add your comments and defects on this file. The Viewer appearance changes a little depending on a type of the current file.

If a version history is available for the file (for example, when it was added from a source control system or when it was reworked by the author), the Diff Viewer shows the current and previous versions of the file and highlights the differences between them.

gs-dev-diff-viewer1

4. Add your comments, look for and verify defects

While reviewing, you most likely find some issues with the materials or would like to ask or tell something to the author. For this purpose you can add comments and defects.

If you are reviewing a file that has already been reworked, then you will need to verify whether the defects have been fixed.

To add a comment, click on the line (in source code and text files), cell (in spreadsheets) or area (in documents and images) you want to comment on, type your comment and click Add. Comments are threaded into a conversation that stays tied to a specific line, cell or area.
ws-review-sidebyside-chat-start
To add a defect, click on the line, cell or area to which you want to attribute the defect, enter issue description and click Add as defect. In the ensuing pane specify defect severity level and type and click Add defect.
ws-review-sidebyside-defect-create-fieldsws-review-sidebyside-defect-created
To mark a previously found defect as fixed, scroll to the defect, expand its log and press Mark fixed.
ws-review-sidebyside-defect-mark-fixed

Besides creating comments and defects that relate to a specific line or area you can also create comments and defects that relate to entire files (in the Overall section of Diff Viewer) as well as comments and defects that relate to the whole review (in the Chat section of the Review Summary screen). See Review Chats for more information on making conversation during reviews.

When you have examined the current file, you can proceed to another file that was uploaded to the review (if any). To view the next or previous files, you may use the File navigation buttons on the Diff Viewer toolbar:

dv_toolbar

Having inspected all the files that were uploaded to the review, return back to the Review Summary screen.

To return back to Review Summary screen, click a button with review number (Review #2 in image above) on the Diff Viewer toolbar.

5. Finish inspection

In Review Summary screen header you can find several review action buttons: Wait, Send to rework, (or Send to completed) and so on.

To signal other participants that you have temporarily stepped out from the review but plan to return, press Wait.
In the ensuing list select when Collaborator should re-invite you to the review.
Wait Options

Wait Options

To indicate that you have found some defects that need to be fixed, press Send to Rework. Thiswill change the review phase to Rework and return it back to author so that he can fix the found defects.
gs-dev-next-steps1
To indicate that you approve the changes in the uploaded materials, press Send to Completed. When all participants approve the review it will be closed. ws-review-next-steps1
A review cannot be closed until all its defects are resolved: either marked as fixed, deleted, or tracked externally.

Where to Go Next

To learn how about correcting the found defects as an author, see Reworking Defects.




© 2018 SmartBear Software. All rights reserved.
Email Send feedback on this document