Manage Review Comments

Reviewers can add notes and comments to files and segments using special dialogs in Swordfish.

File Comments

The Files panel, shown on the left side of a translation tab, contains a list of all files included in the project and looks like this:
Files Panel
  • Clicking on the file name opens the first segment of the file for translation.
  • Clicking on the File Info Icon icon next to a file opens a dialog with information about it.
  • Clicking on the Has Comments Icon (has comments) or No Comments Icon (does not have comments) icons opens the Review Comments dialog for the file.
When you click on the No Comments Icon (no comments) icon, the initial Review Comments dialog appears:
Review Comments Dialog - No Comments
  • Click the Add Comment button to add a new comment to the existing list. When you click on it, the Comments dialog appears:
    Comments Dialog
    Type the information to convey in the Comment text box and click the Save Comment button. The Review Comments dialog is updated and shows a new comment tab:
    Review Comments Dialog
    Click the Add Reply button to open the Comment Reply dialog for responding:
    Comment Reply Dialog
    Type the reply in the Comment text box and click the Save Reply button to update the Review Comments dialog:
    Review Comments with Reply Dialog

Segment Comments

When a segment has review comments, the Review comments icon, (Review Comments Icon) is displayed in the center column of the translation view. Clicking on the icon opens the Review Comments dialog for the selected segment.
Select ViewShow/Hide Review Comments ([Alt+F6] on Windows/Linux, [Option+F6] on macOS) from the main menu or click the Show/Hide Review Comments button on the toolbar of the translation tab top toolbar at any time to show or hide the Review Comments dialog for the active segment.
Segment review comments include more details than file comments. Comments are entered using an enhanced dialog that looks like this:
Segment Comments Dialog
The Categories drop-down contains a list of predefined values for categorizing the comment. The list includes:
  • Mistranslation
  • Accuracy
  • Terminology
  • Consistency
  • Grammar
  • Spelling
  • Punctuation
  • Semantics
  • Country-specific usage
  • Other
The Severity drop-down contains a list of values for grading the reported comment. Possible values are:
  • Minor
  • Major
  • Critical
The Applies To drop-down allows you to indicate if the comment applies to the source or target part of the segment.
Clicking on the Save Comment button adds a new comment tab to the Review Comments dialog.
Replying to a segment comment is done in a dialog like this:
Segment Comment Reply
The Status drop-down allows you to select an optional resolution for the comment. Possible values are:
  • Fixed
  • Ignore
  • Won't Fix
  • Nothing to do