Skip to content

Update file externalization.md with guidelines about contextual namespaces

Oleksandr Pysaryuk requested to merge update-i18n-docs into master

What does this MR do and why?

Related issue: Add i18n guidelines to tech docs about contextu... (gitlab-com/localization/localization-team#253)

This MR adds guidelines to the i18n docs about how to create contextual namespaces for UI messages, such as those in the .pot file

MR acceptance checklist

Please evaluate this MR against the MR acceptance checklist. It helps you analyze changes to reduce risks in quality, performance, reliability, security, and maintainability.

Screenshots or screen recordings

Screenshots are required for UI changes, and strongly recommended for all other merge requests.

Before After

CleanShot 2024-10-10 at 12.07.47@2x.png

CleanShot 2024-10-10 at 12.08.13@2x.png

AI summary by 'Summarize code changes':

The updated guidelines state that namespaces should always be added to UI text messages, even if they seem to be devoid of context or reusable across contexts. This is because natural languages other than English are more contextual, and translators may need to choose different equivalents of words like "Cancel" depending on the context. Namespaces should be in PascalCase.

Edited by Oleksandr Pysaryuk

Merge request reports

Loading