Skip to content

Simplify localization docs#7262

Merged
zivkan merged 2 commits intodevfrom
dev-zivkan-loc-docs
Apr 14, 2026
Merged

Simplify localization docs#7262
zivkan merged 2 commits intodevfrom
dev-zivkan-loc-docs

Conversation

@zivkan
Copy link
Copy Markdown
Member

@zivkan zivkan commented Apr 8, 2026

Bug

Fixes: repo specific docs

Description

Copilot keeps editing xlf files directly, whereas I want it to only edit the resx file, and then build the project and let the tools auto-generate the xlf files.

Sometimes copilot reads docs/localizability.md, so I also updated it to remove a lot of stale data now that NuGet 7+ uses OneLocBuild and xlf files in the same repo. Rather than trying to be a detailed steps by step guide for every use case, I wanted it to be simple, so that external contributors don't feel overwhelmed, and it's less likely to confuse AI into doing the wrong thing.

Also added a section explaining that translation errors need to be fixed in Microsoft's backend, so contributors shouldn't edit the xlf files directly.

PR Checklist

  • Meaningful title, helpful description and a linked NuGet/Home issue
  • Added tests N/A
  • Link to an issue or pull request to update docs if this PR changes settings, environment variables, new feature, etc. N/A

@zivkan zivkan requested a review from a team as a code owner April 8, 2026 00:24
@zivkan zivkan requested review from donnie-msft, kartheekp-ms and martinrrm and removed request for donnie-msft and kartheekp-ms April 8, 2026 00:24
@nkolev92 nkolev92 added the Engineering Changes related to the build infrastructure of the repo and that do not change product code label Apr 8, 2026
nkolev92
nkolev92 previously approved these changes Apr 8, 2026
Comment thread docs/localizability.md
Comment thread docs/localizability.md Outdated
Comment thread docs/localizability.md
Co-authored-by: Nigusu Solomon Yenework <59111203+Nigusu-Allehu@users.noreply.github.com>
@zivkan zivkan merged commit 4de61f2 into dev Apr 14, 2026
17 of 18 checks passed
@zivkan zivkan deleted the dev-zivkan-loc-docs branch April 14, 2026 00:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Engineering Changes related to the build infrastructure of the repo and that do not change product code

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants