Closed
Milestone Nov 18, 2024–Dec 20, 2024

[docs] Parser setup

  • Defining what are the sending for translation and how translators will receive the scoped content.
  • Filtering setup configed by Argo when working on the Argo-Clone roundtrip testing mielstone: docs-site-localization#35 (closed) . Verbatim from the issue description:

Filter Configuration Insights

  • 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.
  • 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.
  • Work items 11
  • Merge requests 0
  • Participants 1
  • Labels 1
Loading
Loading
Loading
Loading
91% complete
91%
Start date
Nov 18, 2024
Nov 18
-
Dec 20 2024
Due date
Dec 20, 2024 (Past due)
11
Work items 11
Open: 1 Closed: 10
None
Total weight
None
0
Merge requests 0
Open: 0 Closed: 0 Merged: 0
0
Releases
None
Reference: gitlab-com/localization%"[docs] Parser setup"