|
CodeCollaborator has the ability to review PDFs. Additionally, CodeCollaborator v6.0 allows Windows users to add any document type, such as Microsoft Office documents, to a review using Print To Review. Other document types on other platforms can be reviewed by converting them to PDF using a conversion tool. Popular converters include (but are not limited to):
Uploading PDFs
To review PDF documents, just attach them to the review as you would any other file and when you open the diff viewer, the content area will display the documents for review.
Uploading Other Document Types Under Windows
Use Print To Review to add Windows documents to a review.
Making Comments
Commenting on documents works exactly like commenting on images.
To comment on the documents, simply click on the document at a point where you would like your comment to appear and begin typing your comment. A blue pushpin ( ) will appear on the image to indicate the location of the currently selected conversation. Other pushpins indicate other conversations on the image:
|
Red
|
Open Defects
|
|
Yellow
|
Unread Comment
|
|
Green
|
Fixed Defects or External Defects
|
|
Grey
|
No Defects
|
The pins may be turned off by clicking the pushpin toggle in the document review toolbar at the bottom of the content pane. This is useful when the pushpins cover important parts of the document.
Alternatively, you may specify an arbitrary label, such as "Section 5.1", to describe the content you are referring to. Using labeled locations decreases the confusion that can occur when large changes occur in a text document resulting in the pushpins not being adjacent to the corresponding text. Label text may not be updated.
Other than the difference in location markers, review chats are handled in the same manner as in reviewing text files.
Documents can only be viewed in a single or side-by-side layout. There is no over-under view available currently for documents.
Note: CodeCollaborator does not compare document file content. Differences in text will not be highlighted, and pushpins on a previous version will remain in the same location coordinates on newer versions.
Side-by-Side PDF Review
Scrollbars are available for each version of the document. You can also hide the version shown on the right by clicking on the arrow in the separator between the two versions. You are also able to move the separator to show more or less of either version. To do this, hover the mouse over the separator until the arrows appear, and click and drag until it reaches the desired location.
To change pages, use the arrows at the bottom left of the comparison screen.
The arrows will allow you to go to the First Page of the Document, the Previous Page, the Next Page, or the Last Page of the document. You can also manually enter a page number and hit enter to jump to any arbitrary page. The page numbers will refer to the latest upload of document shown.
Both the side-by-side and single view support zooming the images in the display. The document review toolbar includes two magnifying glass buttons for zoom and a label displaying the current zoom scale. Zoom out is useful if the page is too large to display in the browser window without scrolling. Zoom is also useful for more precise placement of the comment markers. However, whether zoomed in or out, the comment markers still refer to pixel locations in the image at 100% zoom, so subpixel comments are not supported. If a zoom operation would cause the currently selected location to scroll offscreen, the image will be scrolled to recenter the selected location.
Rescaling of documents is performed by rerendering the document on the CodeCollaborator server and could be slow depending on the size of the document and the selected image scale.
|