docs: Crowdin + MT issue (facebook#9620)

Co-authored-by: Dominique Eav <[email protected]>
weixiabing · Dec 8, 2023 · 61116e2 · 61116e2
1 parent d3752d2
commit 61116e2
Show file tree

Hide file tree

Showing 2 changed files with 9 additions and 0 deletions.
diff --git a/project-words.txt b/project-words.txt
@@ -5,6 +5,7 @@ Agan
 alexbdebrie
 Alexey
 algoliasearch
+Allez
 Anshul
 anshul
 août
@@ -185,6 +186,7 @@ Mdxjs
 mdxjs
 Meilisearch
 meilisearch
+merveilleuse
 metadatum
 metastring
 metrica
@@ -379,6 +381,7 @@ Vieira
 Viet
 Vinnik
 vjeux
+voir
 waivable
 WCAG
 wcag

diff --git a/website/docs/i18n/i18n-crowdin.mdx b/website/docs/i18n/i18n-crowdin.mdx
@@ -515,3 +515,9 @@ import CodeBlock from '@theme/CodeBlock';
     .join('\n')}
 </CodeBlock>
 ```
+
+### Machine Translation (MT) issue: links/image handling
+
+Crowdin recently rolled out some major changes to the markdown file format and now the links are treated differently than they were before. Before they were considered as tags, but now they appear as plain text. Because of these changes the plain text links are passed to the MT engine which attempts to translate the target, thus breaking the translation (for instance: this string `Allez voir [ma merveilleuse page](/ma-merveilleuse-page)` is translated `Check out [my wonderful page](/my-wonderful-page)`, and this breaks docusaurus i18n workflow as the page name should not be translated).
+
+As of 2023 Dec.7, they are not planning to change the logic of how links are treated, so you should have this in mind if you plan to use Crowdin with MT.