fix(l10n): add localization guidance comments for technical terms (#14441)
* fix(l10n): add localization guidance comments for technical terms Add <comment> elements to en-US/Resources.resw providing translation guidance for technical terms that are frequently mistranslated: - File formats (tar, VHD) should not be translated - Technical terms (mount, swap, sparse, DNS, proxy) need locale-appropriate terms - Safe mode should use standard OS terminology These comments help the localization team produce more accurate translations without directly modifying locale-specific files. Ref #14090 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * fix(l10n): add period separators and glossary comment - Add '.' between existing guidance and appended technical term guidance in 16 comment lines (fixes run-on sentences) - Add top-level XML glossary comment listing all technical terms (mount, VHD, tar, swap, sparse, DNS, proxy, safe mode) for developer/reviewer reference Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Gordon Lam committed
May 13, 2026 at 10:10 UTC
c1fab7f8ee8860e2b7d62d885d7731f1b6f54be1
1 file changed
+91
-16
localization/strings/en-US/Resources.resw
+91
-16
@@ -117,6 +117,22 @@
117
<resheader name="writer">
118
<value>System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089</value>
119
</resheader>
120
+ <!--
121
+ Localization Glossary — Technical Terms
122
+ ========================================
123
+ The following technical terms appear in many strings throughout this file.
124
+ Per-string <comment> elements provide guidance for each occurrence, but
125
+ this glossary serves as a central reference for developers and reviewers.
126
+
127
+ "mount" — Making a disk/filesystem accessible. Translate per locale or keep "mount".
128
+ "VHD" — Virtual Hard Disk. Do not translate (file format name).
129
+ "tar" — File archive format. Do not translate (file format name).
130
+ "swap" — Virtual memory swap space. Translate per locale or keep "swap".
131
+ "sparse" — Storage term: file uses disk space only for written data. Translate per locale.
132
+ "DNS" — Domain Name System. Do not translate (protocol acronym).
133
+ "proxy" — Network proxy server. Translate per locale standard networking term.
134
+ "safe mode" — Minimal/diagnostic startup mode. Use standard OS term per locale.
135
+ -->
136
<data name="AppName" xml:space="preserve">
137
<value>Windows Subsystem for Linux</value>
138
</data>
@@ -137,24 +153,27 @@ To force WSL2 to stop and detach the disk, run 'wsl.exe {}'.</value>
153
</data>
154
<data name="MessageDiskAlreadyMounted" xml:space="preserve">
155
<value>That volume is already mounted inside WSL2.</value>
156
+ <comment>"mount" is a technical term meaning to make a disk/filesystem accessible. Use the standard technical term in your locale, or keep "mount" if commonly used.</comment>
157
</data>
158
<data name="MessageDiskMountNameAlreadyExists" xml:space="preserve">
159
<value>A disk with that name is already mounted; please unmount the disk or choose a new name and try again.</value>
160
+ <comment>"mount" is a technical term meaning to make a disk/filesystem accessible. Use the standard technical term in your locale, or keep "mount" if commonly used.</comment>
161
</data>
162
<data name="MessageDiskMountNameInvalid" xml:space="preserve">
163
<value>The specified mount name contains an invalid '/' character. Please retry without the invalid character.</value>
164
+ <comment>"mount" is a technical term meaning to make a disk/filesystem accessible. Use the standard technical term in your locale, or keep "mount" if commonly used.</comment>
165
</data>
166
<data name="MessageDiskMounted" xml:space="preserve">
167
<value>The disk was successfully mounted as '/mnt/wsl/{}'.
168
Note: The location will be different if you have modified the automount.root setting in /etc/wsl.conf.
169
To unmount and detach the disk, run 'wsl.exe {} {}'.</value>
151
- <comment>{FixedPlaceholder="{}"}Command line arguments, file names and string inserts should not be translated</comment>
170
+ <comment>{FixedPlaceholder="{}"}Command line arguments, file names and string inserts should not be translated. "mount" is a technical term meaning to make a disk/filesystem accessible. Use the standard technical term in your locale, or keep "mount" if commonly used.</comment>
171
</data>
172
<data name="MessageDiskMountFailed" xml:space="preserve">
173
<value>The disk was attached but failed to mount: {}.
174
For more details, run 'dmesg' inside WSL2.
175
To detach the disk, run 'wsl.exe {} {}'.</value>
157
- <comment>{FixedPlaceholder="{}"}Command line arguments, file names and string inserts should not be translated</comment>
176
+ <comment>{FixedPlaceholder="{}"}Command line arguments, file names and string inserts should not be translated. "mount" is a technical term meaning to make a disk/filesystem accessible. Use the standard technical term in your locale, or keep "mount" if commonly used.</comment>
177
</data>
178
<data name="MessageDistributionListOnline" xml:space="preserve">
179
<value>The following is a list of valid distributions that can be installed.
@@ -177,6 +196,7 @@ Install using 'wsl.exe {} <Distro>'.
196
</data>
197
<data name="MessageElevationNeededToMountDisk" xml:space="preserve">
198
<value>Administrator access is needed to mount a disk.</value>
199
+ <comment>"mount" is a technical term meaning to make a disk/filesystem accessible. Use the standard technical term in your locale, or keep "mount" if commonly used.</comment>
200
</data>
201
<data name="MessageExportFailed" xml:space="preserve">
202
<value>Exporting the distribution failed.</value>
@@ -303,7 +323,7 @@ For information please visit https://aka.ms/enablevirtualization</value>
323
</data>
324
<data name="MessageUserVhdAlreadyAttached" xml:space="preserve">
325
<value>VHD already mounted via wsl.exe --mount, please unmount the disk before launching.</value>
306
- <comment>{Locked="--mount,"}Command line arguments, file names and string inserts should not be translated</comment>
326
+ <comment>{Locked="--mount,"}Command line arguments, file names and string inserts should not be translated. {Locked="VHD"}"VHD" (Virtual Hard Disk) is a technical format name and should not be translated. "mount" is a technical term meaning to make a disk/filesystem accessible. Use the standard technical term in your locale, or keep "mount" if commonly used.</comment>
327
</data>
328
<data name="MessageWsl1NotSupported" xml:space="preserve">
329
<value>WSL1 is not supported with your current machine configuration.
@@ -602,7 +622,7 @@ Arguments for managing distributions in Windows Subsystem for Linux:
622
"}{Locked="--version,"}{Locked="--export "}{Locked="--format "}{Locked="--import "}{Locked="--version "}{Locked="--vhd
623
"}{Locked="--import-in-place "}{Locked="--list,"}{Locked="--all
624
"}{Locked="--running
605
-"}{Locked="--quiet,"}{Locked="--verbose,"}{Locked="--online,"}{Locked="--install'"}{Locked="--set-default,"}{Locked="--set-version "}{Locked="--terminate,"}{Locked="--unregister "}Command line arguments, file names and string inserts should not be translated</comment>
625
+"}{Locked="--quiet,"}{Locked="--verbose,"}{Locked="--online,"}{Locked="--install'"}{Locked="--set-default,"}{Locked="--set-version "}{Locked="--terminate,"}{Locked="--unregister "}Command line arguments, file names and string inserts should not be translated. {Locked="tar"}"tar" is a file archive format name and should not be translated. {Locked="VHD"}"VHD" (Virtual Hard Disk) is a technical format name and should not be translated. "mount" is a technical term meaning to make a disk/filesystem accessible. Use the standard technical term in your locale, or keep "mount" if commonly used. "sparse" is a technical storage term meaning the file only uses disk space for written data. Use the technical term in your locale.</comment>
626
</data>
627
<data name="MessagePackageVersions" xml:space="preserve">
628
<value>WSL version: {}
@@ -626,7 +646,7 @@ Build time: {}</value>
646
</data>
647
<data name="MessageCustomKernelModulesNotFound" xml:space="preserve">
648
<value>The custom kernel modules VHD in {} was not found: '{}'.</value>
629
- <comment>{FixedPlaceholder="{}"}Command line arguments, file names and string inserts should not be translated</comment>
649
+ <comment>{FixedPlaceholder="{}"}Command line arguments, file names and string inserts should not be translated. {Locked="VHD"}"VHD" (Virtual Hard Disk) is a technical format name and should not be translated.</comment>
650
</data>
651
<data name="MessageCustomSystemDistroError" xml:space="preserve">
652
<value>The custom system distribution specified in {} was not found or is not the correct format.</value>
@@ -687,7 +707,7 @@ Arguments:
707
</data>
708
<data name="MessageWslMountNotSupportedOnArm" xml:space="preserve">
709
<value>wsl.exe --mount on ARM64 requires Windows version 27653 or newer.</value>
690
- <comment>{Locked="--mount "}Command line arguments, file names and string inserts should not be translated</comment>
710
+ <comment>{Locked="--mount "}Command line arguments, file names and string inserts should not be translated. "mount" is a technical term meaning to make a disk/filesystem accessible. Use the standard technical term in your locale, or keep "mount" if commonly used.</comment>
711
</data>
712
<data name="MessageUpdateNotNeeded" xml:space="preserve">
713
<value>The most recent version of Windows Subsystem for Linux is already installed.</value>
@@ -822,6 +842,7 @@ For more information on Admin Protection, please visit https://aka.ms/apdevguide
842
</data>
843
<data name="MessageUsingLegacyDistribution" xml:space="preserve">
844
<value>Using legacy distribution registration. Consider using a tar based distribution instead.</value>
845
+ <comment>{Locked="tar"}"tar" is a file archive format name and should not be translated.</comment>
846
</data>
847
<data name="MessageLegacyDistributionVersionArgNotSupported" xml:space="preserve">
848
<value>Legacy distribution registrations do not support the --version argument.</value>
@@ -853,7 +874,7 @@ For more information on Admin Protection, please visit https://aka.ms/apdevguide
874
</data>
875
<data name="MessagedFailedToCreateSwapVhd" xml:space="preserve">
876
<value>Failed to create the swap disk in '{}': {}</value>
856
- <comment>{FixedPlaceholder="{}"}Command line arguments, file names and string inserts should not be translated</comment>
877
+ <comment>{FixedPlaceholder="{}"}Command line arguments, file names and string inserts should not be translated. "swap" refers to virtual memory swap space. This is a technical term; use the standard OS term in your locale or keep "swap".</comment>
878
</data>
879
<data name="MessageFailedToCreateDisk" xml:space="preserve">
880
<value>Failed to create disk '{}': {}</value>
@@ -872,6 +893,7 @@ For more information on Admin Protection, please visit https://aka.ms/apdevguide
893
</data>
894
<data name="MessageSafeModeEnabled" xml:space="preserve">
895
<value>SAFE MODE ENABLED - many features will be disabled</value>
896
+ <comment>"safe mode" refers to a minimal/diagnostic startup mode. Use the standard OS term for safe mode in your locale.</comment>
897
</data>
898
<data name="MessageMirroredNetworkingNotSupportedReason" xml:space="preserve">
899
<value>Mirrored networking mode is not supported: {}.
@@ -894,24 +916,30 @@ Falling back to NAT networking.</value>
916
</data>
917
<data name="MessageDnsTunnelingNotSupported" xml:space="preserve">
918
<value>DNS Tunneling is not supported</value>
919
+ <comment>{Locked="DNS"}"DNS" (Domain Name System) should not be translated.</comment>
920
</data>
921
<data name="MessageLocalhostForwardingNotSupportedMirroredMode" xml:space="preserve">
922
<value>The wsl2.localhostForwarding setting has no effect when using mirrored networking mode</value>
923
</data>
924
<data name="MessageHttpProxyChangeDetected" xml:space="preserve">
925
<value>An Http Proxy change has been detected on the host. Please restart WSL to apply the change.</value>
926
+ <comment>"proxy" refers to a network proxy server. Use the standard networking term in your locale.</comment>
927
</data>
928
<data name="MessageProxyLocalhostSettingsDropped" xml:space="preserve">
929
<value>A localhost proxy configuration was detected but not mirrored into WSL. WSL in NAT mode does not support localhost proxies.</value>
930
+ <comment>"proxy" refers to a network proxy server. Use the standard networking term in your locale.</comment>
931
</data>
932
<data name="MessageProxyV6SettingsDropped" xml:space="preserve">
933
<value>An IPv6 proxy configuration was detected but not mirrored into WSL. WSL in NAT mode does not support IPv6.</value>
934
+ <comment>"proxy" refers to a network proxy server. Use the standard networking term in your locale.</comment>
935
</data>
936
<data name="MessageProxyLoopbackV6SettingsDropped" xml:space="preserve">
937
<value>A localhost IPv6 proxy configuration was detected but not mirrored into WSL. WSL does not support localhost IPv6 proxies.</value>
938
+ <comment>"proxy" refers to a network proxy server. Use the standard networking term in your locale.</comment>
939
</data>
940
<data name="MessageProxyUnexpectedSettingsDropped" xml:space="preserve">
941
<value>An unexpected error occurred while attempting to resolve proxy settings, proxy settings were not mirrored into WSL.</value>
942
+ <comment>"proxy" refers to a network proxy server. Use the standard networking term in your locale.</comment>
943
</data>
944
<data name="MessageRegistryError" xml:space="preserve">
945
<value>An error occurred accessing the registry. Path: '{}'. Error: {}</value>
@@ -954,7 +982,7 @@ Falling back to NAT networking.</value>
982
</data>
983
<data name="MessageWSLMountDisabled" xml:space="preserve">
984
<value>wsl.exe --mount is disabled by the computer policy.</value>
957
- <comment>{Locked="--mount "}Command line arguments, file names and string inserts should not be translated</comment>
985
+ <comment>{Locked="--mount "}Command line arguments, file names and string inserts should not be translated. "mount" is a technical term meaning to make a disk/filesystem accessible. Use the standard technical term in your locale, or keep "mount" if commonly used.</comment>
986
</data>
987
<data name="MessageWSL1Disabled" xml:space="preserve">
988
<value>WSL1 is disabled by the computer policy.</value>
@@ -1017,7 +1045,7 @@ Falling back to NAT networking.</value>
1045
</data>
1046
<data name="MessageVhdInUse" xml:space="preserve">
1047
<value>The operation could not be completed because the VHD is currently in use. To force WSL to stop use: wsl.exe --shutdown</value>
1020
- <comment>{Locked="--shutdown"}Command line arguments, file names and string inserts should not be translated</comment>
1048
+ <comment>{Locked="--shutdown"}Command line arguments, file names and string inserts should not be translated. {Locked="VHD"}"VHD" (Virtual Hard Disk) is a technical format name and should not be translated.</comment>
1049
</data>
1050
<data name="MessageInvalidBoolean" xml:space="preserve">
1051
<value>{} is not a valid boolean, <true|false></value>
@@ -1025,6 +1053,7 @@ Falling back to NAT networking.</value>
1053
</data>
1054
<data name="MessageSparseVhdWsl2Only" xml:space="preserve">
1055
<value>Sparse VHD is supported on WSL2 only.</value>
1056
+ <comment>{Locked="VHD"}"VHD" (Virtual Hard Disk) is a technical format name and should not be translated. "sparse" is a technical storage term meaning the file only uses disk space for written data. Use the technical term in your locale.</comment>
1057
</data>
1058
<data name="MessageLocalSystemNotSupported" xml:space="preserve">
1059
<value>Running WSL as local system is not supported.</value>
@@ -1074,7 +1103,7 @@ Falling back to NAT networking.</value>
1103
</data>
1104
<data name="MessagePassVhdFlag" xml:space="preserve">
1105
<value>This looks like a VHD file. Use --vhd to import a VHD instead of a tar.</value>
1077
- <comment>{Locked="--vhd "}Command line arguments, file names and string inserts should not be translated</comment>
1106
+ <comment>{Locked="--vhd "}Command line arguments, file names and string inserts should not be translated. {Locked="tar"}"tar" is a file archive format name and should not be translated. {Locked="VHD"}"VHD" (Virtual Hard Disk) is a technical format name and should not be translated.</comment>
1107
</data>
1108
<data name="MessageDistroStoreInstallFailed" xml:space="preserve">
1109
<value>Failed to install {} from the Microsoft Store: {}
@@ -1122,23 +1151,26 @@ Error code: {}</value>
1151
</data>
1152
<data name="MessageDnsTunnelingDisabled" xml:space="preserve">
1153
<value>Due to a current compatibility issue with Global Secure Access Client, DNS Tunneling is disabled.</value>
1154
+ <comment>{Locked="DNS"}"DNS" (Domain Name System) should not be translated.</comment>
1155
</data>
1156
<data name="MessageSparseVhdDisabled" xml:space="preserve">
1157
<value>Sparse VHD support is currently disabled due to potential data corruption.
1158
To force a distribution to use a sparse VHD, please run:
1159
wsl.exe --manage <DistributionName> --set-sparse true --allow-unsafe</value>
1130
- <comment>{Locked="--manage "}{Locked="--set-sparse "}{Locked="--allow-unsafe"}Command line arguments, file names and string inserts should not be translated</comment>
1160
+ <comment>{Locked="--manage "}{Locked="--set-sparse "}{Locked="--allow-unsafe"}Command line arguments, file names and string inserts should not be translated. {Locked="VHD"}"VHD" (Virtual Hard Disk) is a technical format name and should not be translated. "sparse" is a technical storage term meaning the file only uses disk space for written data. Use the technical term in your locale.</comment>
1161
</data>
1162
<data name="MessageDrvfsMountFailed" xml:space="preserve">
1163
<value>Failed to mount {}, see dmesg for more details.</value>
1134
- <comment>{FixedPlaceholder="{}"}Command line arguments, file names and string inserts should not be translated</comment>
1164
+ <comment>{FixedPlaceholder="{}"}Command line arguments, file names and string inserts should not be translated. "mount" is a technical term meaning to make a disk/filesystem accessible. Use the standard technical term in your locale, or keep "mount" if commonly used.</comment>
1165
</data>
1166
<data name="MessageFstabMountFailed" xml:space="preserve">
1167
<value>Processing /etc/fstab with mount -a failed.</value>
1168
+ <comment>"mount" is a technical term meaning to make a disk/filesystem accessible. Use the standard technical term in your locale, or keep "mount" if commonly used.</comment>
1169
</data>
1170
<data name="MessageReadOnlyDistro" xml:space="preserve">
1171
<value>An error occurred mounting the distribution disk, it was mounted read-only as a fallback.
1172
See recovery instructions on: https://aka.ms/wsldiskmountrecovery</value>
1173
+ <comment>"mount" is a technical term meaning to make a disk/filesystem accessible. Use the standard technical term in your locale, or keep "mount" if commonly used.</comment>
1174
</data>
1175
<data name="MessageFailedToTranslate" xml:space="preserve">
1176
<value>Failed to translate '{}'</value>
@@ -1177,28 +1209,35 @@ See recovery instructions on: https://aka.ms/wsldiskmountrecovery</value>
1209
</data>
1210
<data name="Settings_AutoProxy.Header" xml:space="preserve">
1211
<value>Auto Proxy enabled</value>
1212
+ <comment>"proxy" refers to a network proxy server. Use the standard networking term in your locale.</comment>
1213
</data>
1214
<data name="Settings_AutoProxy.Description" xml:space="preserve">
1215
<value>Enables WSL to use Windows' HTTP proxy information.</value>
1216
+ <comment>"proxy" refers to a network proxy server. Use the standard networking term in your locale.</comment>
1217
</data>
1218
<data name="Settings_AutoProxyToggleSwitch.AutomationProperties.Name" xml:space="preserve">
1219
<value>Auto Proxy enabled.</value>
1220
+ <comment>"proxy" refers to a network proxy server. Use the standard networking term in your locale.</comment>
1221
</data>
1222
<data name="Settings_AutoProxyToggleSwitch.AutomationProperties.HelpText" xml:space="preserve">
1223
<value>Enables WSL to use Windows' HTTP proxy information.</value>
1224
+ <comment>"proxy" refers to a network proxy server. Use the standard networking term in your locale.</comment>
1225
</data>
1226
<data name="Settings_BestEffortDNS.Header" xml:space="preserve">
1227
<value>Use best effort DNS parsing</value>
1228
+ <comment>{Locked="DNS"}"DNS" (Domain Name System) should not be translated.</comment>
1229
</data>
1230
<data name="Settings_BestEffortDNS.Description" xml:space="preserve">
1231
<value>Only applicable when wsl2.dnsTunneling is set to true. When set to true, Windows will extract the question from the DNS request and attempt to resolve it, ignoring the unknown records.</value>
1195
- <comment>{Locked="wsl2.dnsTunneling"}.wslconfig property key names should not be translated</comment>
1232
+ <comment>{Locked="wsl2.dnsTunneling"}{Locked="DNS"}.wslconfig property key names should not be translated. "DNS" (Domain Name System) should not be translated.</comment>
1233
</data>
1234
<data name="Settings_BestEffortDNSToggleSwitch.AutomationProperties.Name" xml:space="preserve">
1235
<value>Use best effort DNS parsing.</value>
1236
+ <comment>{Locked="DNS"}"DNS" (Domain Name System) should not be translated.</comment>
1237
</data>
1238
<data name="Settings_BestEffortDNSToggleSwitch.AutomationProperties.HelpText" xml:space="preserve">
1239
<value>Only applicable when wsl2.dnsTunneling is set to true. When set to true, Windows will extract the question from the DNS request and attempt to resolve it, ignoring the unknown records.</value>
1240
+ <comment>{Locked="DNS"}"DNS" (Domain Name System) should not be translated.</comment>
1241
</data>
1242
<data name="Settings_CustomKernelPath.Header" xml:space="preserve">
1243
<value>Custom kernel</value>
@@ -1220,6 +1259,7 @@ See recovery instructions on: https://aka.ms/wsldiskmountrecovery</value>
1259
</data>
1260
<data name="Settings_CustomKernelModulesPath.Description" xml:space="preserve">
1261
<value>An absolute Windows path to a custom Linux kernel modules VHD.</value>
1262
+ <comment>{Locked="VHD"}"VHD" (Virtual Hard Disk) is a technical format name and should not be translated.</comment>
1263
</data>
1264
<data name="Settings_CustomKernelModulesPathBrowseButton.Content" xml:space="preserve">
1265
<value>Browse kernel modules</value>
@@ -1229,6 +1269,7 @@ See recovery instructions on: https://aka.ms/wsldiskmountrecovery</value>
1269
</data>
1270
<data name="Settings_CustomKernelModulesPathTextBox.AutomationProperties.HelpText" xml:space="preserve">
1271
<value>An absolute Windows path to a custom Linux kernel modules VHD.</value>
1272
+ <comment>{Locked="VHD"}"VHD" (Virtual Hard Disk) is a technical format name and should not be translated.</comment>
1273
</data>
1274
<data name="Settings_CustomSystemDistroPath.Header" xml:space="preserve">
1275
<value>Custom system distro</value>
@@ -1238,7 +1279,7 @@ See recovery instructions on: https://aka.ms/wsldiskmountrecovery</value>
1279
</data>
1280
<data name="Settings_CustomSystemDistroPathDescription.Text" xml:space="preserve">
1281
<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>
1241
- <comment>{Locked="["}{Locked="]"}The text in between the delimiters [ ] is made into a hyperlink in code, and the delimiters are removed</comment>
1282
+ <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>
1283
</data>
1284
<data name="Settings_CustomSystemDistroPathDescription.NavigateUri" xml:space="preserve">
1285
<value>https://aka.ms/wslgsystemdistro</value>
@@ -1249,6 +1290,7 @@ See recovery instructions on: https://aka.ms/wsldiskmountrecovery</value>
1290
</data>
1291
<data name="Settings_CustomSystemDistroPathTextBox.AutomationProperties.HelpText" xml:space="preserve">
1292
<value>Specify a path to a VHD which will load as a custom system distro, primarily used to power GUI apps in WSL.</value>
1293
+ <comment>{Locked="VHD"}"VHD" (Virtual Hard Disk) is a technical format name and should not be translated.</comment>
1294
</data>
1295
<data name="Settings_DebugConsole.Header" xml:space="preserve">
1296
<value>Enable debug console</value>
@@ -1264,18 +1306,22 @@ See recovery instructions on: https://aka.ms/wsldiskmountrecovery</value>
1306
</data>
1307
<data name="Settings_DefaultVHDSize.Header" xml:space="preserve">
1308
<value>Default VHD Size</value>
1309
+ <comment>{Locked="VHD"}"VHD" (Virtual Hard Disk) is a technical format name and should not be translated.</comment>
1310
</data>
1311
<data name="Settings_DefaultVHDSize.Description" xml:space="preserve">
1312
<value>The default max size for the expandable WSL virtual hard disk (VHD) for newly created distributions only.</value>
1313
+ <comment>{Locked="VHD"}"VHD" (Virtual Hard Disk) is a technical format name and should not be translated.</comment>
1314
</data>
1315
<data name="Settings_DefaultVHDSizeResetButton.Content" xml:space="preserve">
1316
<value>Reset size</value>
1317
</data>
1318
<data name="Settings_DefaultVHDSizeTextBox.AutomationProperties.Name" xml:space="preserve">
1319
<value>Default VHD Size</value>
1320
+ <comment>{Locked="VHD"}"VHD" (Virtual Hard Disk) is a technical format name and should not be translated.</comment>
1321
</data>
1322
<data name="Settings_DefaultVHDSizeTextBox.AutomationProperties.HelpText" xml:space="preserve">
1323
<value>The default max size, specified in megabytes, for the expandable WSL virtual hard disk (VHD) for newly created distributions only.</value>
1324
+ <comment>{Locked="VHD"}"VHD" (Virtual Hard Disk) is a technical format name and should not be translated.</comment>
1325
</data>
1326
<data name="Settings_DeveloperPageTitle.Text" xml:space="preserve">
1327
<value>Developer</value>
@@ -1295,28 +1341,35 @@ See recovery instructions on: https://aka.ms/wsldiskmountrecovery</value>
1341
</data>
1342
<data name="Settings_DNSProxy.Header" xml:space="preserve">
1343
<value>DNS Proxy enabled</value>
1344
+ <comment>{Locked="DNS"}"DNS" (Domain Name System) should not be translated. "proxy" refers to a network proxy server. Use the standard networking term in your locale.</comment>
1345
</data>
1346
<data name="Settings_DNSProxy.Description" xml:space="preserve">
1347
<value>Only applicable when wsl2.networkingMode is set to NAT. Boolean to inform WSL to configure the DNS Server in Linux to the NAT on the host. Setting to false will mirror DNS servers from Windows to Linux.</value>
1301
- <comment>{Locked="wsl2.networkingMode"}.wslconfig property key names should not be translated</comment>
1348
+ <comment>{Locked="wsl2.networkingMode"}{Locked="DNS"}.wslconfig property key names should not be translated. "DNS" (Domain Name System) should not be translated.</comment>
1349
</data>
1350
<data name="Settings_DNSProxyToggleSwitch.AutomationProperties.Name" xml:space="preserve">
1351
<value>DNS Proxy enabled.</value>
1352
+ <comment>{Locked="DNS"}"DNS" (Domain Name System) should not be translated. "proxy" refers to a network proxy server. Use the standard networking term in your locale.</comment>
1353
</data>
1354
<data name="Settings_DNSProxyToggleSwitch.AutomationProperties.HelpText" xml:space="preserve">
1355
<value>Only applicable when wsl2.networkingMode is set to NAT. Boolean to inform WSL to configure the DNS Server in Linux to the NAT on the host. Setting to false will mirror DNS servers from Windows to Linux.</value>
1356
+ <comment>{Locked="DNS"}"DNS" (Domain Name System) should not be translated.</comment>
1357
</data>
1358
<data name="Settings_DNSTunneling.Header" xml:space="preserve">
1359
<value>DNS Tunneling enabled</value>
1360
+ <comment>{Locked="DNS"}"DNS" (Domain Name System) should not be translated.</comment>
1361
</data>
1362
<data name="Settings_DNSTunneling.Description" xml:space="preserve">
1363
<value>Changes how DNS requests are proxied from WSL to Windows.</value>
1364
+ <comment>{Locked="DNS"}"DNS" (Domain Name System) should not be translated.</comment>
1365
</data>
1366
<data name="Settings_DNSTunnelingToggleSwitch.AutomationProperties.Name" xml:space="preserve">
1367
<value>DNS Tunneling enabled.</value>
1368
+ <comment>{Locked="DNS"}"DNS" (Domain Name System) should not be translated.</comment>
1369
</data>
1370
<data name="Settings_DNSTunnelingToggleSwitch.AutomationProperties.HelpText" xml:space="preserve">
1371
<value>Changes how DNS requests are proxied from WSL to Windows.</value>
1372
+ <comment>{Locked="DNS"}"DNS" (Domain Name System) should not be translated.</comment>
1373
</data>
1374
<data name="Settings_FileSystemPageTitle.Text" xml:space="preserve">
1375
<value>File System</value>
@@ -1392,19 +1445,22 @@ See recovery instructions on: https://aka.ms/wsldiskmountrecovery</value>
1445
</data>
1446
<data name="Settings_InitialAutoProxyTimeout.Header" xml:space="preserve">
1447
<value>Initial Auto Proxy timeout</value>
1448
+ <comment>"proxy" refers to a network proxy server. Use the standard networking term in your locale.</comment>
1449
</data>
1450
<data name="Settings_InitialAutoProxyTimeout.Description" xml:space="preserve">
1451
<value>Only applicable when wsl2.autoProxy is set to true. Configures how long (in milliseconds) WSL will wait for retrieving HTTP proxy information when starting a WSL container. If proxy settings are resolved after this time, the WSL instance must be restarted to use the retrieved proxy settings.</value>
1398
- <comment>{Locked="wsl2.autoProxy"}.wslconfig property key names should not be translated</comment>
1452
+ <comment>{Locked="wsl2.autoProxy"}.wslconfig property key names should not be translated. "proxy" refers to a network proxy server. Use the standard networking term in your locale.</comment>
1453
</data>
1454
<data name="Settings_InitialAutoProxyTimeoutResetButton.Content" xml:space="preserve">
1455
<value>Reset timeout</value>
1456
</data>
1457
<data name="Settings_InitialAutoProxyTimeoutTextBox.AutomationProperties.Name" xml:space="preserve">
1458
<value>Initial Auto Proxy timeout</value>
1459
+ <comment>"proxy" refers to a network proxy server. Use the standard networking term in your locale.</comment>
1460
</data>
1461
<data name="Settings_InitialAutoProxyTimeoutTextBox.AutomationProperties.HelpText" xml:space="preserve">
1462
<value>Only applicable when wsl2.autoProxy is set to true. Configures how long, in milliseconds, WSL will wait for retrieving HTTP proxy information when starting a WSL container. If proxy settings are resolved after this time, the WSL instance must be restarted to use the retrieved proxy settings.</value>
1463
+ <comment>"proxy" refers to a network proxy server. Use the standard networking term in your locale.</comment>
1464
</data>
1465
<data name="Settings_KernelCommandLine.Header" xml:space="preserve">
1466
<value>Kernel Command Line</value>
@@ -1580,6 +1636,7 @@ Some of the benefits of using Docker Desktop with WSL are:
1636
• You can run Docker commands in WSL or in Windows, using the same Docker daemon and images.
1637
• You can share files and folders between Windows and Linux seamlessly, using the automatic mount of Windows drives in WSL.
1638
• You can use your preferred Windows tools and editors to work on Linux code and files, and vice versa, thanks to the interoperability of WSL.</value>
1639
+ <comment>"mount" is a technical term meaning to make a disk/filesystem accessible. Use the standard technical term in your locale, or keep "mount" if commonly used.</comment>
1640
</data>
1641
<data name="Settings_OOBEDockerDesktopIntegration.Title" xml:space="preserve">
1642
<value>Docker Desktop Integration</value>
@@ -1747,15 +1804,19 @@ You can also access more VS Code Remote options through the command palette with
1804
</data>
1805
<data name="Settings_SafeMode.Header" xml:space="preserve">
1806
<value>Enable safe mode</value>
1807
+ <comment>"safe mode" refers to a minimal/diagnostic startup mode. Use the standard OS term for safe mode in your locale.</comment>
1808
</data>
1809
<data name="Settings_SafeMode.Description" xml:space="preserve">
1810
<value>Run WSL in "Safe Mode" which disables many features and is intended to be used to recover distributions that are in bad states.</value>
1811
+ <comment>"safe mode" refers to a minimal/diagnostic startup mode. Use the standard OS term for safe mode in your locale.</comment>
1812
</data>
1813
<data name="Settings_SafeModeToggleSwitch.AutomationProperties.Name" xml:space="preserve">
1814
<value>Enable safe mode.</value>
1815
+ <comment>"safe mode" refers to a minimal/diagnostic startup mode. Use the standard OS term for safe mode in your locale.</comment>
1816
</data>
1817
<data name="Settings_SafeModeToggleSwitch.AutomationProperties.HelpText" xml:space="preserve">
1818
<value>Run WSL in "Safe Mode" which disables many features and is intended to be used to recover distributions that are in bad states.</value>
1819
+ <comment>"safe mode" refers to a minimal/diagnostic startup mode. Use the standard OS term for safe mode in your locale.</comment>
1820
</data>
1821
<data name="Settings_Shell_About.Content" xml:space="preserve">
1822
<value>About</value>
@@ -1820,45 +1881,58 @@ You can also access more VS Code Remote options through the command palette with
1881
</data>
1882
<data name="Settings_SparseVHD.Header" xml:space="preserve">
1883
<value>Enable sparse VHD by default</value>
1884
+ <comment>{Locked="VHD"}"VHD" (Virtual Hard Disk) is a technical format name and should not be translated. "sparse" is a technical storage term meaning the file only uses disk space for written data. Use the technical term in your locale.</comment>
1885
</data>
1886
<data name="Settings_SparseVHD.Description" xml:space="preserve">
1887
<value>Any newly created VHD will be set to sparse automatically when enabled.</value>
1888
+ <comment>{Locked="VHD"}"VHD" (Virtual Hard Disk) is a technical format name and should not be translated. "sparse" is a technical storage term meaning the file only uses disk space for written data. Use the technical term in your locale.</comment>
1889
</data>
1890
<data name="Settings_SparseVHDToggleSwitch.AutomationProperties.Name" xml:space="preserve">
1891
<value>Enable sparse VHD by default.</value>
1892
+ <comment>{Locked="VHD"}"VHD" (Virtual Hard Disk) is a technical format name and should not be translated. "sparse" is a technical storage term meaning the file only uses disk space for written data. Use the technical term in your locale.</comment>
1893
</data>
1894
<data name="Settings_SparseVHDToggleSwitch.AutomationProperties.HelpText" xml:space="preserve">
1895
<value>Any newly created VHD will be set to sparse automatically when enabled.</value>
1896
+ <comment>{Locked="VHD"}"VHD" (Virtual Hard Disk) is a technical format name and should not be translated. "sparse" is a technical storage term meaning the file only uses disk space for written data. Use the technical term in your locale.</comment>
1897
</data>
1898
<data name="Settings_SwapFilePath.Header" xml:space="preserve">
1899
<value>Swap File Location</value>
1900
+ <comment>"swap" refers to virtual memory swap space. This is a technical term; use the standard OS term in your locale or keep "swap".</comment>
1901
</data>
1902
<data name="Settings_SwapFilePath.Description" xml:space="preserve">
1903
<value>An absolute Windows path to the swap virtual hard disk.</value>
1904
+ <comment>"swap" refers to virtual memory swap space. This is a technical term; use the standard OS term in your locale or keep "swap".</comment>
1905
</data>
1906
<data name="Settings_SwapFilePathBrowseButton.Content" xml:space="preserve">
1907
<value>Browse swap files</value>
1908
+ <comment>"swap" refers to virtual memory swap space. This is a technical term; use the standard OS term in your locale or keep "swap".</comment>
1909
</data>
1910
<data name="Settings_SwapFilePathTextBox.AutomationProperties.Name" xml:space="preserve">
1911
<value>Swap File Location</value>
1912
+ <comment>"swap" refers to virtual memory swap space. This is a technical term; use the standard OS term in your locale or keep "swap".</comment>
1913
</data>
1914
<data name="Settings_SwapFilePathTextBox.AutomationProperties.HelpText" xml:space="preserve">
1915
<value>An absolute Windows path to the swap virtual hard disk.</value>
1916
+ <comment>"swap" refers to virtual memory swap space. This is a technical term; use the standard OS term in your locale or keep "swap".</comment>
1917
</data>
1918
<data name="Settings_SwapSize.Header" xml:space="preserve">
1919
<value>Swap Size</value>
1920
+ <comment>"swap" refers to virtual memory swap space. This is a technical term; use the standard OS term in your locale or keep "swap".</comment>
1921
</data>
1922
<data name="Settings_SwapSize.Description" xml:space="preserve">
1923
<value>How much swap space to add to the WSL 2 VM, 0 for no swap file. Swap storage is disk-based RAM used when memory demand exceeds limit on hardware device.</value>
1924
+ <comment>"swap" refers to virtual memory swap space. This is a technical term; use the standard OS term in your locale or keep "swap".</comment>
1925
</data>
1926
<data name="Settings_SwapSizeResetButton.Content" xml:space="preserve">
1927
<value>Reset size</value>
1928
</data>
1929
<data name="Settings_SwapSizeTextBox.AutomationProperties.Name" xml:space="preserve">
1930
<value>Swap Size</value>
1931
+ <comment>"swap" refers to virtual memory swap space. This is a technical term; use the standard OS term in your locale or keep "swap".</comment>
1932
</data>
1933
<data name="Settings_SwapSizeTextBox.AutomationProperties.HelpText" xml:space="preserve">
1934
<value>How much swap space, specified in megabytes, to add to the WSL 2 VM. 0 for no swap file. Swap storage is disk-based RAM used when memory demand exceeds limit on hardware device.</value>
1935
+ <comment>"swap" refers to virtual memory swap space. This is a technical term; use the standard OS term in your locale or keep "swap".</comment>
1936
</data>
1937
<data name="Settings_Virtio.Header" xml:space="preserve">
1938
<value>Enable VirtIO</value>
@@ -1871,6 +1945,7 @@ You can also access more VS Code Remote options through the command palette with
1945
</data>
1946
<data name="Settings_Virtio9p.Description" xml:space="preserve">
1947
<value>Enables mount of the 9P filesystem from the host using the virtio transport.</value>
1948
+ <comment>"mount" is a technical term meaning to make a disk/filesystem accessible. Use the standard technical term in your locale, or keep "mount" if commonly used.</comment>
1949
</data>
1950
<data name="Settings_VMIdleTimeout.Header" xml:space="preserve">
1951
<value>VM Idle timeout</value>