fix(l10n): add localization guidance comments for commonly mistranslated terms

[Gordon Lam (yeelam-gordon)]

Summary

Adds <comment> elements to en-US/Resources.resw providing translation guidance for terms that are frequently mistranslated by the automated localization pipeline.

The problem

Issue #14100 reports inaccurate Spanish translations in the WSL Settings UI. The pipeline produced incorrect or nonsensical translations for common terms:

Term	Reported Spanish	Problem	Fix applied
Developer	Programador	"Programmer" wrong platform term (should be "Desarrollador")	Comment guidance (cannot {Locked} e.g., de-DE correctly uses "Entwickler", fr-FR "Développeur", ja-JP "開発者")
distro	Pulsación del sistema personalizada	"Keystroke of custom system" nonsensical machine-translation artifact	Comment guidance explaining "distro" = "distribution" (e.g., fr-FR uses "Distribution", ja-JP "ディストリビューション")
power (as in "power GUI apps")	encender aplicaciones	"turn on apps" wrong sense of "power"	Comment guidance clarifying "power" = "run/drive" (enable functionality), not "turn on a device"

Comment guidance means a <comment> element is added to each affected string explaining the term's intended meaning and instructing translators to use the correct term in their locale. These terms cannot use {Locked} because they have valid locale-specific translations in other languages (as shown in the examples above).

Note: Some other es-ES issues (e.g., "DNS" expanded to "Servicio de nombres de dominio") are already addressed by the companion PR #14441, which adds {Locked="DNS"} markers.

What this PR does NOT fix

The following es-ES issues require direct localization team intervention, as they are not caused by the terms this PR or #14441 covers:

Type	Example	Line
Machine-translation artifact	"WSLg" split into "WSL g"	L1334
Grammar error	Singular verb with plural subject in HyperVFirewall.Description	L1352
.wslconfig value errors	Literal config values (NAT, false) mangled in DNSProxy.Description	L1296

PR Checklist

• Ref: Partially addresses Spanish translations in WSL settings are inaccurate and differ from documentation #14100 (adds guidance comments for the 3 reported terms: developer, distro, power; remaining es-ES issues listed above need localization team review)
• Localization: Adds guidance comments to en-US source strings for better localization quality

Validation Steps Performed

• XML parse validation passed
• validate-localization.py passes
• Only en-US/Resources.resw modified (no locale files changed)

[Copilot]

Pull request overview

Updates Spanish (es-ES) localized strings for the WSL Settings UI to improve terminology accuracy and consistency with intended meanings.

Changes:

• Refines multiple WSL Settings UI translations (e.g., “Programador” → “Desarrollador”, WSLg/GUI terminology, “Custom system distro” wording).
• Adjusts several settings descriptions/help texts for clarity and consistency.

---

You can also share your feedback on Copilot code review. Take the survey.

[Copilot]

Pull request overview

Updates the en-US localization resource comments to better guide translators toward accurate terminology (notably around “Developer” and “custom system distro”), helping prevent mistranslations in localized WSL Settings UI strings.

Changes:

• Refines the translator note for Settings_AppDescription regarding the meaning of “developers”.
• Adds clarifying translator comments for “Custom system distro” and the meaning of “power” in the related description text.
• Adds guidance comments for “Developer” strings to avoid translating it as “Programmer”.

---

You can also share your feedback on Copilot code review. Take the survey.

[Copilot]

Pull request overview

This PR adds translator guidance comments to the en-US resource file to reduce recurring localization errors for WSL Settings terminology (e.g., “Developer”, “distro”, and “power” in the sense of “enable/run”).

Changes:

• Added a clarifying comment for “developers” in the app description string.
• Added “distro = distribution” guidance for some “Custom system distro” strings.
• Added “power = run/drive (enable functionality)” guidance for the “Custom system distro” description/help text.

---

You can also share your feedback on Copilot code review. Take the survey.

[Gordon Lam (yeelam-gordon)]

/azp run

[azure-pipelines]

Azure Pipelines successfully started running 1 pipeline(s).

[Copilot]

Pull request overview

Adds translator-facing guidance in the en-US resource source file to reduce common mistranslations (notably around “Developer”, “distro”, and “power … GUI apps”) without changing localized resource files.

Changes:

• Adds new <comment> guidance for “distro” strings in the Settings UI.
• Adds new <comment> guidance clarifying “power” in the “power GUI apps” context.
• Updates/adds “Developer” guidance comments (including the app description and navigation strings).

[Copilot]

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 1 comment.

[Ben Hillis (benhillis)]

Hi! This PR is approved but has merge conflicts with master. Could you rebase when you have a chance so we can land it? Thanks!

[Gordon Lam (yeelam-gordon)]

Rebased onto master and squashed into a single commit. Conflicts in the localization guidance comments (due to upstream {Locked="VHD"} additions) have been resolved — both the VHD and the distro/power/developer guidance are preserved. Ready to merge!

[Copilot]

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated no new comments.