Enhancing the Translation Process

Add File or String Instructions

This article is for Account Owners and Project Managers.

File and string instructions help Translators understand the content that they are translating by providing your Translators with additional helpful information about the content they are translating. Therefore, file and string instructions are the most basic form of "context".

File instructions belong to the source file and are presented to the translators in all languages.

String instructions belong to the source string and are presented to the translators in all languages.

You cannot set a file or string instruction for a specific target locale but you can refer to the specific target locale in the instruction.

You cannot set a file or string instructions for a specific workflow step but you can refer to the specific workflow step in the instruction.

String instructions are visible to all users in the Strings View via the Strings Detail dialog and are highlighted in the CAT Tool. String instructions are not visible to reviewers using the Review Mode.

 

Add String Instructions for Translators (New Experience)

To add Translator instructions to individual strings, locate the string(s).

  • From a Project, click the Strings tab. 
  • From a Job, click View Strings.
  • You can use search or filters to locate the string.
  1. Select the string(s). 
  2. Click Actions and select Edit Translator Instructions
  3. Click Add Instructions and enter the instructions. 
  4. Click Add

Screenshot_2020-10-02_at_13.17.18.png

From here, you can choose to remove any existing string instructions by click Remove Instructions and check "Remove instructions from the selected strings", and click Remove.

Screenshot_2020-10-02_at_13.18.06.png

 

Add String Instructions for Translators (Classic)

You can add Translator instructions to individual strings.

  1. Go to Content > Translations.
  2. Use the search filters to find the strings you want.
  3. Select the specific strings by using the checkboxes.
  4. Click the Actions drop-down menu and select Add Translator Instructions.
  5. In the New Instruction text box, enter the instructions.
  6. Click Save

Add File Instructions for Translators (New Experience)

To add Translator instructions to files, which automatically puts the instructions into all translatable strings in the file:

  1. From a project, click the Files tab.
  2. In the top right corner of the file, click the three dots, and select Edit File Instructions.
  3. Add instructions or attach a file.
  4. Click Save.  

Note: From here, you can also choose to upload an additional file as a job attachment for even further context.

Screenshot_2020-10-02_at_13.09.08.png

 

An information icon will appear on any files with file instructions

Screenshot_2020-10-02_at_13.12.30.png

 

Add File Instructions for Translators (Classic)

You can add Translator instructions to files, which automatically adds the instructions to all translatable strings in the file.

  1. Go to Content > Files.
  2. Use the search filters to find the file you want.
  3. At the right of the file entry, click the more icon, and select Add File Instructions.
  4. In the Add File Instructions dialog box, enter the instructions and/or attach a file, such as a PDF.

Instructions are visible to Translators from:

  • The Additional Details section of the CAT tool.
  • In the Classic Experience, Content > Translations then clicking the drop-down menu and selecting View Instructions.

Strings or Files with instructions display the 'i' icon next to them. You can click the icon to view or edit the instruction. 

 

Viewing String Instructions in the Strings View of the Dashboard

As mentioned above, string instructions are visible to all users in the Strings View via the Strings Detail dialog.

  • Navigate to the Strings View of the Job
    • From the Job, click View Strings, or click the Strings tab and filter for the Job or search for the source keyword.
  • On the string, click the 3 dots under Actions > View String Instructions

Screenshot_2020-10-02_at_14.43.15.png

 

This will open the String Details dialog where you can view the string instructions. From here, you can choose to edit, delete or add string instructions. Furthermore, here you can also view the string Issues and string History.

Screenshot_2020-10-02_at_14.49.04.png

 

Viewing String Instructions in the CAT Tool

String instructions appear within an orange banner above the source string it was added to.

 

Screenshot_2020-10-02_at_13.29.36.png

 

Viewing File Instructions in the CAT Tool

File instructions appear within the Additional Details panel of the CAT Tool beside File Instruction. You will also find a download link for any additional job attachments here.

Screenshot_2020-10-02_at_13.40.56.png

 

Considerations when using Instructions

File directives

When translating content using CSV or resource file types, you can apply string instructions directly from within the source file by using a string instruction directive. The directive essentially points to the instruction and associated string. Please consult your chosen source file documentation for applicable string instruction directives.

Integration

When translating content via the Smartling API or other integration, string instructions can also be configured from within the integration, if this is not done so automatically. Please consult your Solutions Architect or developer for more on including string instruction functionality within your integration.

Placeholders 

If your content contains dynamic content that you want to exclude from translation, such as discount amounts, names, or footer information, you can use placeholders to secure this text and exclude it from translation. This is a preferred method over adding an instruction to "not translate" a term within a string.

HTML 

If your content includes HTML, Smartling will automatically capture and reformat the HTML into numbered tags in the CAT Tool so linguists know they do not have to translate the HTML. This means you do not have to add a string instruction to direct linguists not to translate the HTML. Linguists in the CAT Tool have the option to toggle tags to reveal the HTML, should they wish to do so.

Character Limits

If you want to instruct translators to translate within a certain character limit, it's best to apply the character limit to the string using the Edit Character Limit function under string Actions. This will flag the character limit to the translators in the CAT Tool as they translate. Quality Checks can also be configured so an error will flag if translations exceed the character limit.

Issues

If a translator opens a source Issue requiring clarification or further context in order to translate a string, it might be worth considering adding a string or file instruction in addition to answering the Issue. Although Issues are visible to all li guists working on a translation Job, the information could be missed to all linguists unless they check the Issues panel in the CAT Tool. Adding an instruction will ensure the information will not be missed, as it will appear highlighted in orange, above the string, as shown above.

 

 

 

 

Was this article helpful?