The CAT Tool

Ask a Question

The Issues feature allows platform users to communicate about original source content or translations directly in the Smartling platform. Ensure your Global Notification Preferences are enabled to receive Issue notifications.

Ask a Question

  1. From within the CAT tool, click on the relevant string.
  2. Click Open New Issue in the Issue panel on the right side of the CAT tool.
  3. Select Source/Translation to indicate where the issue appears.
  4. Choose the Issue Subtype from the dropdown.
  5. Describe your issue or question in the text box.
  6. Click Open this issue to open your issue or Cancel to exit.

Markdown format links are supported in Issue text. Place link text in square brackets followed immediately by the URL in parentheses [Link Text](http:/www.link-url.com)

Issue Types

Source

Source issue notifications are sent to the Account Owner and Project Manager users on the account (if preferences are en enabled). For questions/comments in relation to the source copy, you can open a source issue under the following subtypes;

  • Question/Clarification: Question about the source content (e.g. what is a "Smart Inbox"). 
  • Typo/Misspelling: Mistake in the source content (i.e. were vs. where).

Translation

Translation issues are comments, questions or queries in relation to the translation submitted to a string. In order for an email notification to be sent to the translation resource user who submitted the string, the user opening the issue must do so by rejecting the translation. However, slack notifications will be sent regardless if the string is rejected. Account Owner and Project Manager users can reject a string in the Strings View Actions or, like Agency Account Owner, Translation Resource Managers and Translation Resource users, by clicking X on a string from within the CAT Tool.

Translation issues are locale-specific, meaning only the Translation Resource user working on a locale for that string, will receive a notification, by default. Any other user may receive a notification on translation issues after they participate in the issue (open an issue /comment on an issue). A translation issue can be opened without moving the string back a step - ie a reviewer can open a translation issue on a translation without rejecting the string. However, it is important to note that a notification will not be sent if the string is not accessible to the user who needs to revise the translation.

If the workflow is configured to allow users to reject content to another step (e.g., the review step), then the translation issue created when rejecting a string will be sent to the user who submitted the string on that specific step (e.g., the reviewer).

  • Review Translation: Translation requires revision.
  • Doesn't Fit Space: The translation does not fit the space allotted in the asset design. You can then apply a character limit to the string for further guidance.
  • Placeholder Issue: Placeholder balancing or ordering is incorrect.
  • Poor Translation: Translation does not meet tone, brand, or quality guidelines.

Subtypes can be customized for the account. Your Account Owner or Project Manager can contact a Smartling Customer Success Manager to request custom subtypes. They are specific to either source or translation type.

Severity

To highlight the priority of the issue, you can select a severity level from the dropdown from High, Medium, or Low. The default severity will always be Medium and can be modified at any time, even for "closed" issues. This field is optional.

Watchers

Any email address can be added as a watcher by an Account Owner, Project Manager, or Agency Account Owner users. Watchers receive notifications about an issue being opened, commented on, or closed. This field is optional.

A watcher can add comments and add attachments to issues via email. Other aspects of the issue must be managed via the web dashboard.

Account Owner, Project Manager, or Agency Account Owner users can also remove any watcher from the list, regardless of which user added the watcher to the list.

Reply to a Comment

To ensure you will receive email notification in relation to issues, ensure notifications are enabled. You will then receive an email when an issue is opened or commented on. Click the link in the email to go directly to the open issue where you can add a comment and/or close the issue if your question is answered. Alternatively, you can reply to the issue via email.

To view and respond to an issue:

  1. Go to Content > TranslationsThe number of open issues will be displayed in the upper right corner of the screen.
  2. Click on Translation issues or Source issues to filter on strings with open issues.
  3. Hover over a string and click View Issue.
  4. Click on the Issue text to expose the comment field.
  5. Enter your comment and click Comment to reply or Comment & Close to reply and close the ticket in one action.

You can also reply to issues in the CAT tool by clicking on Issues in the side panel.

Strings that are flagged with issues will have a red vertical bar on the left side of the string Screenshot_2020-06-09_at_15.29.23.png

Close an Issue

Though all issue participants can close an issue, we recommend that the user that opened an issue is the one to close the issue once their question has been answered.

Issue Assignment

By default, the user who opens the issue is the user assigned. The Account Owner or Project Manager can re-assign issues.

Issue Visibility and Notifications

Notifications are sent depending on the notification type, the condition, and whether the user has opted to receive that kind of notification.

  • All Source Issues are sent to Account Owners and Project Managers (from the project that the Job is in).
  • All Translation Issues are sent to the translator who translated the string.
  • Any user who opens or comments on any Issue will be notified of subsequent comments and when the issue is closed, even if the translations are published.

 

  Source Issue Translation Issue
Agency Account Owner
  • Can view, update, and close.
  • Receives source issue notifications only if they participate in the issue (open/comment).
  • Can view, update, and close if they have access to the relevant language.
  • Receives translation issue notifications only if they participate in the issue (open/comment).
Translation Resource / Translation Resource Manager
  • Can view, update, and close.
  • Receives source issue notifications only if they participate in the issue (open/comment).
  • Can view, update, and close if they have access to the relevant language.
  • Receives notifications if they worked on the translation or if they participate in the translation issue (open/comment).
Account Owner /
Project Manager
  • Can view, update, and close.
  • Receives notifications for all source issues.
  • Can view, update, and close.
  • Receives notifications for translation issues they participate in the issue (open/comment).
Requester
  • Can view, update, and close.
  • Receives source issue notifications only if they participate in the issue (open/comment).

  • Can view, update, and close.
  • Receives notifications for translation issues they participate in the issue (open/comment).

Was this article helpful?