Skip to content

Commit e9206f2

Browse files
authored
Create README.md
1 parent 2fa1831 commit e9206f2

1 file changed

Lines changed: 45 additions & 0 deletions

File tree

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)