Review Comments Quick Step Guide

Guide
A Quick Step Guide on reviewing and replying to comments in the Review Comments List in ProjectDox.

Review Comments List

For a PDF version of this guide, click here.

All review comments are managed by the Review Comments list. This is where reviewers and process managers will leave comments, markups, and inquiries for applicants and where applicants can respond. There are two ways to access the Review Comments list:

  1. Through a task eForm (Prescreen Corrections Task or Applicant Resubmit Task)
  2. The project’s Reviews tab

Review Comments List - Task eForm

If you receive a task requiring corrections, you will be directed to the Review Comments list to see comments, markups, and inquiries left by reviewers.

  1. Select the task name. For this example, we will select the Applicant Resubmit Task.  
    Accept Applicant Resubmit Task
    Accept Applicant Resubmit Task
  2. Back on the eForm, scroll down to the step where you respond to comments. This is usually title Step 1 on the eForm.
    • The type of comment and number of comments for each type are counted for you. This will change as the workflow progresses and more reviews are added.
  3. Select Review Comments. 
    Review Comments button on eForm
    Review Comments button on eForm
  4. The Review Comments list will launch in a new window. 

In the Review Comments list, you will find four different types of comments: Markups, Library Comment, Comments, and Inquiry.

  • Markups have comments or notations placed on a specific area of a drawing to denote a needed change.
  • Library Comments and Comments are more general and apply to the plan set as a whole.
  • Inquiries are questions and give reviewers the ability to start a dialog with applicants.

Comments can be categorized into four statuses: Resolved, Unresolved, Info Only, and Question. The status of a comment might change as the workflow progresses.

  • Resolved means changes meet the requirement or code.
  • Unresolved means changes do not meet the requirement or code.
  • Info Only is a comment used by the Reviewer to share information with the applicant. These comments do not need to be responded to or resolved.
  • Questions are inquires made by the reviewer or you, the applicant. Answer questions directly in the yellow column.
    Comment Type and Status (left column)
    Comment Type and Status (left column)

Ensure a respond is provided to every unresolved item. 

Responding to Markups

Markups have comments or notations placed on a specific area of a drawing to denote a needed change. These markups do not alter the plan sheet or drawing, they are just there to help guide you as you make your changes.

  1. Select the thumbnail of the drawing image or the drawing name hyperlink. Selecting the drawing name hyperlink will launch the image in the Brava viewer for easier viewing.
  2. Markups are placed on drawings as clouds or bubbles. Different colored clouds are used for different review groups. Hover over the cloud to read the markup or view it from the list in the panel on the right. 
    Markups on drawings (example)
    Markups on drawings (example)
  3. Close the viewer.
  4. Respond to the markup on the Review Comments list in the yellow column on the far right.
    • Responses are automatically saved and automatically captures the authors data (date and time stamp, user’s name, cycle number, etc.) 
      Response column and responder data
      Response column and responder data
  5. Make changes on the original drawing and use the exact same file name so that the files version correctly. Please watch our training video on YouTube called File Naming Standards and Applicant Upload to learn more. You can also read more in this Quick Step Guide: File Naming Standards.
  6. Upload the corrected files from the task eForm.

Responding to Comments and Inquiries 

Library comments, comments, and inquiries can be responded to directly on the Review Comments list.

  1. Sort comments by Newest First
    Sort by Newest First
    Sort by Newest First
  2. Read the comment left by the reviewer.
  3. Respond directly in the yellow column on the far right.
    • Responses are automatically saved and automatically captures the authors data (date and time stamp, user’s name, cycle number, etc.)
  4. Close the Review Comments list and return to the eForm to complete the task.

Review Comments List - Reviews Tab

Another way to access the Review Comments list is through the Reviews tab.

  1. Select the name of your Project.
  2. Select the Reviews tab.

Follow all of the steps above to respond to markups, comments, and inquiries.

Note: Corrections tasks cannot be resubmitted through the Review Comments list. After responses are complete, return back to the task eForm to submit the task back to the City.