Filter configurations (Argo-Clone roundtrip testing)

Summary of the testing process, and the main findings regarding filter configurations on Phrase for Argo-Clone roundtrip testing:

General findings from the test

  • The task is considered done for the purpose of testing the roundtrip on Argo Clone.
  • Tests were run with GitLab docs YAML files, and all seems to be working correctly.
  • Segmentation for markdown files (e.g., debian.md) looks perfect with the applied settings (see screenshot in comment)
  • GitLab markdown is related to GitHub markdown, with some differences noted in the documentation.

Filter Configuration Insights

  • Disabling "Import code blocks" prevents content inside triple backticks from being translatable.
  • Enabling "Exclude code elements" places links and single backtick content inside placeholder tags, which can be edited if needed in the Phrase UI.
  • Additional tests were run successfully (MANPHR-5 and MANPHR-6).

Specific Concerns Addressed ⚠️

  1. URLs: Can be modified as tags in Phrase.
  2. Code lines/blocks: Either fully translatable or not translatable. Recommendation is to leave them untranslatable in most cases.
  3. Tables: Filtered correctly, allowing all rows and column strings to be translatable
  4. Code blocks:
    1. Generally recommended to be left untranslatable to avoid technical errors due to over-localization
    2. If translation of comments in code blocks is necessary, filter settings would need to be adjusted.
Edited by Maria Jose Salmeron Ibáñez