For Developers

Top  Previous  Next
1. Download a client

       You'll most likely need a client if you plan on uploading files from your Version Control/SCM.  Download the "Client Installer" listed under your platform from the Download page, http://www.smartbearsoftware.com/codecollab-download.php.  For more information about clients and to find out which is most appropriate for you, visit the Clients Section.

 

2. Installation Wizard

       Once you've downloaded the installer, open it to begin the installation wizard.  The wizard should guide you through the steps below:

       a.  Welcome Screen

       This just welcomes you to the installation process.  Click Next to proceed.

       b.  EULA

       Read the license agreement, and select "I accept the agreement" before clicking Next.

       c.  Destination Directory

       Choose the folder where you would like the Code Collaborator client to be installed.  You'll need at least 22 MB of disk space.

       d.  Start Menu Folder

       Select a Start Menu folder where you'd like to create the Code Collaborator shortcut.

       e.  Code Collaborator Configuration

       Here, you will enter the Code Collaborator server URL, username, and password.  Remember to specify the protocol (e.g. http:// or https://) and port number, and path.  If you do not know this, ask your Code Collaborator system administrator.

       f.  Additional Tasks

       Choose whether to run the Tray Notifier on Startup.

       g.  Finish

       Click Finish, and you're done installing the client.

 

3. Configure the Client to your SCM

       GUI - Open up the GUI Client, and click Add... on the right side of the window.  Use the Configuration wizard to enter the location of your local source code into the Local Path field at the top.  For more information, please visit the GUI Client section.

       Command-Line -  SCM configuration is usually detected automatically.  For more information, visit the Command Line Client page.

 

4. Log into the Web Browser Client

       Open a web browser, and go to the Code Collaborator server URL provided by your system administrator.  Enter your login name and password.  Once you log in, you can check your Action Items to see if you have any assigned reviews.  You can also edit Preferences by clicking Prefs in the menu bar on the top right of the screen.

 

5. Create a Review as an Author

       1.  Click New Review in the menu bar at the top right to create a new review.

       2.  Fill in the basic information such as title and participants in the review wizard.

       3.  Add review materials via one of the clients or the web browser.

       a.  GUI Client - Click on the SCM Configuration you created in Step 3.  Use the Add to Review buttons at the bottom to add materials to the review.

       b.  Command-Line - Visit the Command Line Client section for specifics.

       c.  Web browser - You can add supporting documents not under Version Control by clicking Attach File in the Materials section.

       4.  Click Apply and Begin Review to start the review and send out notifications to participants.

 

6. Add Comments and Defects as a Reviewer

       You will receive an email inviting you to participate in a review.  Click the link in the email to open the review in your web browser.  Under the Review Materials section, click a file.  The diff view will open, and you will be able to make comments and defects here.

       Comment - Click on the line you want to comment on, and type your comment.  Comments will be threaded into a conversation, and unread comments from other users will be marked in yellow.  You can click Accept or Mark Read to clear the unread markings.

       Defects - Click on the line you want to attribute the defect to.  Make sure the Add Defect tab is selected and write a description of your defect, filling in the fields underneath.  Once a defect is made, you can mark the defect as fixed, edit the defect, delete the defect, or track it externally by using the links at the bottom of the comment box.  If defects are found in the review, authors should fix the defects and upload the fixes, and the reviewer should inspect the code again until the code is acceptable.

 

7. Finish the Review

       Once all the defects are found and all the comments are read, you can finish the review by clicking Finished at the bottom of the Moving On section in your web browser client.