Articles

[Collapse]Collaborator 10
 [Expand]General Information/viewarticle/80040/
 [Collapse]Getting Started/viewarticle/80359/
   Getting Started For System Administrators/viewarticle/80348/
  [Collapse]Getting Started For Developers/viewarticle/80397/
    Creating Reviews/viewarticle/80394/
    Participating in Reviews/viewarticle/80395/
    Reworking Defects/viewarticle/80396/
 [Expand]Collaborator Server/viewarticle/80060/
 [Expand]Web Client/viewarticle/80107/
 [Expand]Desktop Clients/viewarticle/80151/
 [Expand]Version Control Integration/viewarticle/80048/
 [Expand]External Integrations/viewarticle/80340/
 [Expand]Techniques & Best Practices/viewarticle/80403/
 [Expand]Appendices/viewarticle/80117/
Updated: 12/23/2016 Applies To: Collaborator 10 Rating: No votes Click to rate: PoorNot badAverageGoodExcellent

Getting Started > Getting Started For Developers

Top |Previous |Next

Creating Reviews

You have several options for creating a review: via Collaborator Web Client, via GUI Client or via Command-Line Client. Besides you can reviews directly from Eclipse, Visual Studio or from P4V or P4Win clients for Perforce. To ease you into the process, we will start with the Web Client. It does not need any client components except for web browser.

1. Open Collaborator Web Client

Start your favorite web browser and navigate to the URL of the Collaborator Web Client. If you do not know the URL, ask your Collaborator administrator. The URL is defined by the External URL setting.

2. Log Into the Web User Interface

You will be redirected to the login screen.

ws-login-create

Enter your user name and password and click Login. The username and password is typically supplied by the administrator.

If you use LDAP or ActiveDirectory for authentication in your company, you can use that username/password with Collaborator and it will automatically create your user account.

If your administrator allows user created logins, a "Create New Account" form appears on the login page where you can create your own login name and password. In this case we recommend that your account in Collaborator be identical to your version control system account.

3. Get Familiar With Web Client Home Page

Once you log in, you will be redirected to the Home page. This page is a starting point for most of peer review process.

gs-dev-home

On Home page you can check your Action Items to see if you have any assigned reviews. You can also edit and change your settings and preferences by clicking Settings in the menu bar on the top right of the screen.

4. Create a New Review

To create a new review, click Create New Review on the Home screen.

ws-revew-create-toolbar

You will see a Create Review Screen where you can specify information about the newly created review.

5. Specify General Information About a Review

ws-review-create-general

Enter a brief description for the review to the Review Title field. The title is used all over the place -- in Action Items, in notification emails, in web page titles, and so forth.

All other fields of the General Information section are optional, so you may skip them.

6. Add Review Participants

The next step in creating a review is to invite people to the review, and give each of them a role to play.

ws-review-create-participants

1. Add yourself as Author.
2. Add one or more of your colleagues as Reviewers.

You can select each user and role individually through the drop-down menu, or start typing the name of the user in the appropriate field to narrow down the user list. User/role combinations you have used recently will also appear under "Recent Participants". This makes it easy and fast to select common combinations.

7. Add Review Materials

Review materials is what you are asking to review. From the Web Client you can upload the following types of content:

Arbitrary files from your computer: text files, Word documents, Excel tables, PDF's, images and so on.
Links to Web sites
Changes committed to a pre-configured version control system

Let's upload some text file to a review.

1. Scroll to the Review Materials section.
2. Click the Upload button.
3. Select Files from the drop-down list.
4. In the ensuing dialog, choose one or more files you want to attach and then click Upload.

Once you have attached anything to a review, it will be listed in the Review Materials section.

gs-dev-review-materials1

Most Collaborator users do not use the Web Client for attaching source files, reserving it for adding supporting documents. Instead, most of our users opt to use the GUI Client, the Command-Line Client, or add source files directly from Eclipse, Visual Studio or from P4V or P4Win clients for Perforce.

These clients need to be installed on your computer and properly configured, however they provide an extensive integration with Source Control Systems and/or IDEs.

To learn how to add review materials via these clients, please read the respective sections in the manual: GUI Client, Command-Line Client, Eclipse Plug-in, Visual Studio Plug-in or P4V / P4Win Integration.

8. Start the Review

Click Begin Review to start a review.

ws-review-create-finishing

In the ensuing list select when Collaborator should re-invite you to the review.

ws-review-next-steps-wait

Other participants will receive notifications about your new review, and it will be displayed in their Action Items list.

Where to Go Next

To learn how to take park in someone else's reviews as a reviewer or observer, see Participating in Reviews.

To learn how to get to know about the issues other participants have found in your review, see Reworking Defects.




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