Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 18 additions & 0 deletions localize/LocProject.json
Original file line number Diff line number Diff line change
@@ -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"
}
]
}
]
}
45 changes: 45 additions & 0 deletions localize/README.md
Original file line number Diff line number Diff line change
@@ -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
Loading