fix(l10n): add localization guidance comments for commonly mistranslated terms (#14440)
Add translator-facing guidance comments in the en-US resource file to reduce common mistranslations. Adds guidance for: - 'Developer' (software developer, not programmer) - 'distro' (short for distribution) - 'power' (run/drive, not turn on a device) - '.wslconfig' (file name, do not translate) Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Gordon Lam committed
Jul 8, 2026 at 08:16 UTC
c30d9e0874027a367b459c49ce0f1dab1f142ab8
1 file changed
+8
-3
localization/strings/en-US/Resources.resw
+8
-3
@@ -1215,7 +1215,7 @@ See recovery instructions on: https://aka.ms/wsldiskmountrecovery</value>
1215
</data>
1216
<data name="Settings_AppDescription" xml:space="preserve">
1217
<value>Windows Subsystem for Linux Settings lets developers manage the .wslconfig file using a GUI-based application.</value>
1218
- <comment>{Locked=".wslconfig"}Command line arguments, file names and string inserts should not be translated</comment>
1218
+ <comment>{Locked=".wslconfig"}Command line arguments, file names and string inserts should not be translated. "developers" refers to software developers broadly. Use the standard platform term for "developer" in your locale.</comment>
1219
</data>
1220
<data name="Settings_AutoMemoryReclaim.Header" xml:space="preserve">
1221
<value>Auto memory reclaim</value>
@@ -1295,13 +1295,15 @@ See recovery instructions on: https://aka.ms/wsldiskmountrecovery</value>
1295
</data>
1296
<data name="Settings_CustomSystemDistroPath.Header" xml:space="preserve">
1297
<value>Custom system distro</value>
1298
+ <comment>"distro" is short for "distribution" (a Linux distribution). Translate as "distribution" in your locale, not literally. "Custom system distro" = "Custom system distribution".</comment>
1299
</data>
1300
<data name="Settings_CustomSystemDistroPathBrowseButton.Content" xml:space="preserve">
1301
<value>Browse distros</value>
1302
+ <comment>"distro" is short for "distribution" (a Linux distribution). Translate as "distribution" in your locale, not literally.</comment>
1303
</data>
1304
<data name="Settings_CustomSystemDistroPathDescription.Text" xml:space="preserve">
1305
<value>Specify a path to a VHD which will load as a custom system distro, primarily used to power GUI apps in WSL. [Learn more about system distros here].</value>
1304
- <comment>{Locked="["}{Locked="]"}{Locked="VHD"}The text in between the delimiters [ ] is made into a hyperlink in code, and the delimiters are removed. "VHD" (Virtual Hard Disk) is a technical format name and should not be translated.</comment>
1306
+ <comment>{Locked="["}{Locked="]"}{Locked="VHD"}The text in between the delimiters [ ] is made into a hyperlink in code, and the delimiters are removed. "VHD" (Virtual Hard Disk) is a technical format name and should not be translated. "distro" is short for "distribution" (a Linux distribution). Translate as "distribution" in your locale, not literally. "power" here means "run" or "drive" (to enable functionality), not "turn on" a device.</comment>
1307
</data>
1308
<data name="Settings_CustomSystemDistroPathDescription.NavigateUri" xml:space="preserve">
1309
<value>https://aka.ms/wslgsystemdistro</value>
@@ -1309,10 +1311,11 @@ See recovery instructions on: https://aka.ms/wsldiskmountrecovery</value>
1311
</data>
1312
<data name="Settings_CustomSystemDistroPathTextBox.AutomationProperties.Name" xml:space="preserve">
1313
<value>Custom system distro</value>
1314
+ <comment>"distro" is short for "distribution" (a Linux distribution). Translate as "distribution" in your locale, not literally. "Custom system distro" = "Custom system distribution".</comment>
1315
</data>
1316
<data name="Settings_CustomSystemDistroPathTextBox.AutomationProperties.HelpText" xml:space="preserve">
1317
<value>Specify a path to a VHD which will load as a custom system distro, primarily used to power GUI apps in WSL.</value>
1315
- <comment>{Locked="VHD"}"VHD" (Virtual Hard Disk) is a technical format name and should not be translated.</comment>
1318
+ <comment>{Locked="VHD"}"VHD" (Virtual Hard Disk) is a technical format name and should not be translated. "distro" is short for "distribution" (a Linux distribution). Translate as "distribution" in your locale, not literally. "power" here means "run" or "drive" (to enable functionality), not "turn on" a device.</comment>
1319
</data>
1320
<data name="Settings_DebugConsole.Header" xml:space="preserve">
1321
<value>Enable debug console</value>
@@ -1347,6 +1350,7 @@ See recovery instructions on: https://aka.ms/wsldiskmountrecovery</value>
1350
</data>
1351
<data name="Settings_DeveloperPageTitle.Text" xml:space="preserve">
1352
<value>Developer</value>
1353
+ <comment>"Developer" refers to a software developer (a person who creates software), not specifically a "programmer". Use the standard platform term for "Developer" in your locale and avoid translating it as "Programmer".</comment>
1354
</data>
1355
<data name="Settings_DocumentationLink.Content" xml:space="preserve">
1356
<value>Documentation</value>
@@ -1846,6 +1850,7 @@ You can also access more VS Code Remote options through the command palette with
1850
</data>
1851
<data name="Settings_Shell_Developer.Content" xml:space="preserve">
1852
<value>Developer</value>
1853
+ <comment>"Developer" refers to a software developer (a person who creates software), not specifically a "programmer". Use the standard platform term for "Developer" in your locale and avoid translating it as "Programmer".</comment>
1854
</data>
1855
<data name="Settings_Shell_DistroManagement.Content" xml:space="preserve">
1856
<value>Distro Management</value>