From 2fa1831deb89d8e0fc8b72f2a07e74cb74b03b2a Mon Sep 17 00:00:00 2001 From: kyongk <60981664+kyongk@users.noreply.github.com> Date: Tue, 19 Aug 2025 22:07:13 -0700 Subject: [PATCH 1/2] Create LocProject.json --- localize/LocProject.json | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) create mode 100644 localize/LocProject.json diff --git a/localize/LocProject.json b/localize/LocProject.json new file mode 100644 index 0000000000..697be5c3fb --- /dev/null +++ b/localize/LocProject.json @@ -0,0 +1,18 @@ +{ + "_comment": "Find the details on 'Author Localization Project File' at https://eng.ms/docs/cloud-ai-platform/azure-core/azure-experiences-and-ecosystems/cme-international-customer-exp/software-localization-onelocbuild/onelocbuild/onboarding/localizationproject or https://aka.ms/OneLocBuild", + "Projects": [ + { + "LanguageSet": "CRM_44_Languages", + "_LanguageSet.comment": "Find the details at https://dev.azure.com/ceapex/CEINTL/_git/SWSys-Build-XLoc?path=/src/OneBranchPackages/Localization.Languages/Localization.Languages.props", + "CloneLanguageSet": "BizApp_CloneLanguages1", + "_CloneLanguageSet.comment": "Find the details at https://dev.azure.com/ceapex/CEINTL/_git/SWSys-Build-XLoc?path=/src/OneBranchPackages/Localization.Languages/Localization.CloneLanguageSets.json", + "LocItems": [ + { + "SourceFile": "packages\\api\\src\\Localization\\en-US.json", + "OutputPath": "packages\\api\\src\\Localization\\{Lang}.resx", + "CopyOption": "UsePlaceholders" + } + ] + } + ] +} From e9206f26bc4a583dfd8f8f3e064ee052586ff2ca Mon Sep 17 00:00:00 2001 From: kyongk <60981664+kyongk@users.noreply.github.com> Date: Tue, 19 Aug 2025 22:08:42 -0700 Subject: [PATCH 2/2] Create README.md --- localize/README.md | 45 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 45 insertions(+) create mode 100644 localize/README.md diff --git a/localize/README.md b/localize/README.md new file mode 100644 index 0000000000..4ebe743593 --- /dev/null +++ b/localize/README.md @@ -0,0 +1,45 @@ +# Localization + +This directory contains the required localization configuration file (`LocProject.json`) that services this repository. This file controls which resources are included in the localization pipeline. + + +## Maintenance Tasks + +### Localization PRs + +Our service generates localization PRs using the `Juno-OneLocBuild-Prod` Managed Identity. Please ensure these PRs are approved in a timely manner to guarantee the latest translations are included in builds. We ask teams to prioritize the completion of these PRs continuously. + +### Adding New Resource Files for Localization + +To add new resource files for localization: + +1. In the `LocProject.json` file, add a new entry in the `LocItems` array following the existing pattern (all relative paths are from the root of the repository): + ```json + { + "SourceFile": "folder-A\\folder-B\\folder-C\\YourResourceFile.en-US.resx", + "OutputPath": "folder-A\\folder-B\\folder-C\\YourResourceFile.{Lang}.resx", + "CopyOption": "UsePlaceholders" + } + ``` + +2. For additional OutputPath bin placing naming conventions, visit [https://aka.ms/AllAboutLoc](https://aka.ms/AllAboutLoc) (refer to 'Author Localization Project File' topic) or [here](https://eng.ms/docs/cloud-ai-platform/azure-core/azure-experiences-and-ecosystems/cme-international-customer-exp/software-localization-onelocbuild/onelocbuild/onboarding/localizationproject#copyoption-outputpath-optional). + +### File Changes + +- **Deleted files**: Remove corresponding entries from the LocProject file +- **Renamed files**: Update `SourceFile` and `OutputPath` in the LocProject file +- **Files no longer needing localization**: Remove those entries from the LocProject file + +### Localization Bugs + +To report any localization bugs or issues with the deliverables, contact us at https://aka.ms/AllAboutLoc + +## Important Notes + +⚠️ **Before expanding language support or onboarding new repos for localization:** + +Contact the localization team at [https://aka.ms/AllAboutLoc](https://aka.ms/AllAboutLoc) to: + +- Ensure language expansion is approved +- Verify sufficient localization budget +- Plan localization timeline