Skip to content

Commit a15a06c

Browse files
authored
Introducing 'LocProject.json' & 'README.md' for the migration of the localization platform to Juno (#5555)
* Create LocProject.json * Create README.md
1 parent b052134 commit a15a06c

File tree

2 files changed

+63
-0
lines changed

2 files changed

+63
-0
lines changed

localize/LocProject.json

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
{
2+
"_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",
3+
"Projects": [
4+
{
5+
"LanguageSet": "CRM_44_Languages",
6+
"_LanguageSet.comment": "Find the details at https://dev.azure.com/ceapex/CEINTL/_git/SWSys-Build-XLoc?path=/src/OneBranchPackages/Localization.Languages/Localization.Languages.props",
7+
"CloneLanguageSet": "BizApp_CloneLanguages1",
8+
"_CloneLanguageSet.comment": "Find the details at https://dev.azure.com/ceapex/CEINTL/_git/SWSys-Build-XLoc?path=/src/OneBranchPackages/Localization.Languages/Localization.CloneLanguageSets.json",
9+
"LocItems": [
10+
{
11+
"SourceFile": "packages\\api\\src\\Localization\\en-US.json",
12+
"OutputPath": "packages\\api\\src\\Localization\\{Lang}.resx",
13+
"CopyOption": "UsePlaceholders"
14+
}
15+
]
16+
}
17+
]
18+
}

localize/README.md

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
# Localization
2+
3+
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.
4+
5+
6+
## Maintenance Tasks
7+
8+
### Localization PRs
9+
10+
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.
11+
12+
### Adding New Resource Files for Localization
13+
14+
To add new resource files for localization:
15+
16+
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):
17+
```json
18+
{
19+
"SourceFile": "folder-A\\folder-B\\folder-C\\YourResourceFile.en-US.resx",
20+
"OutputPath": "folder-A\\folder-B\\folder-C\\YourResourceFile.{Lang}.resx",
21+
"CopyOption": "UsePlaceholders"
22+
}
23+
```
24+
25+
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).
26+
27+
### File Changes
28+
29+
- **Deleted files**: Remove corresponding entries from the LocProject file
30+
- **Renamed files**: Update `SourceFile` and `OutputPath` in the LocProject file
31+
- **Files no longer needing localization**: Remove those entries from the LocProject file
32+
33+
### Localization Bugs
34+
35+
To report any localization bugs or issues with the deliverables, contact us at https://aka.ms/AllAboutLoc
36+
37+
## Important Notes
38+
39+
⚠️ **Before expanding language support or onboarding new repos for localization:**
40+
41+
Contact the localization team at [https://aka.ms/AllAboutLoc](https://aka.ms/AllAboutLoc) to:
42+
43+
- Ensure language expansion is approved
44+
- Verify sufficient localization budget
45+
- Plan localization timeline

0 commit comments

Comments
 (0)