diff --git a/docs/localizability.md b/docs/localizability.md index 1833d1c180f..cb06451679c 100644 --- a/docs/localizability.md +++ b/docs/localizability.md @@ -24,9 +24,11 @@ Unfortunately, NuGet.Client does not use OneLocBuild, and any resource comments Although the steps below are for the dev branch, the process is similar for release branches. 1. A PR merges into the dev branch. -1. A NuGet.Client build generates a `localizationArtifacts` artifact. This artifact contains newly built (but unsigned) assemblies and .lcg files. The .lcg files contain information extracted from .resx files and are the primary input for later localization. +1. A NuGet.Client build generates a `localizationArtifacts` artifact. This artifact contains newly built Authenticode-signed assemblies [(see PR#6170)][12]) containing English resources and .lcg files. +The .lcg files contain information extracted from .resx files and are the primary input for later localization. 1. The localization team grabs the `localizationArtifacts` artifact from a NuGet.Client build. -1. The localization team localizes strings and merges a ["LEGO" PR][5] with localized strings (in .lcl files). +1. The localization team localizes strings. +The signed assemblies are used to validate the exported .lcl won't break the build before the team merges a ["LEGO" PR][5] with localized strings (in .lcl files). 1. During the next NuGet.Client build, the build adds the [NuGet.Build.Localization][6] repository as a submodule of the NuGet.Client repository and checks out a branch of the same name as the NuGet.Client repository (e.g.: dev, release-6.7.x, etc.). Localized resources are [made available][7] to localized builds through the `NuGetBuildLocalizationRepository` property. 1. When the build completes, the product is localized using localizations based on an earlier commit. (This means strings added since then won't be localized.) @@ -149,4 +151,5 @@ private void DoSomething(ILogger logger) [8]: https://github.com/NuGet/NuGet.Build.Localization/blob/931c5f21742fff61c7f53a19039b89dddc7a01cd/localize/comments/15/NuGet.Packaging.dll.lci#L58-L66 [9]: https://github.com/dotnet/sign/blob/ef0e6b3ef8281dff1d62cea34445bd88fc3e6714/src/Sign.Core/Resources.resx#L131-L134 [10]: https://aka.ms/allaboutloc -[11]: https://devdiv.visualstudio.com/DevDiv/_wiki/wikis/DevDiv.wiki/20709/MicroBuild-Localization \ No newline at end of file +[11]: https://devdiv.visualstudio.com/DevDiv/_wiki/wikis/DevDiv.wiki/20709/MicroBuild-Localization +[12]: https://github.com/NuGet/NuGet.Client/pull/6170