Update i18n doc with loadTranslations and $localize

📚 Docs or angular.io bug report

Description

Issue first reported in https://github.com/angular/angular/issues/35776. Related issue about length of document: https://github.com/angular/angular/issues/33461

Developers want the following:

Please add docs for loadTranslations and clearTranslations. Use i18n for library in ng-packagr.

🔬 Minimal Reproduction

What’s the affected URL?**

https://angular.io/guide/i18n#internationalization-i18n

Reproduction Steps**

Expected vs Actual Behavior**

Some of this content requires a description of $localize, which is not a public API yet.

Doc team wants to separate the i18n doc into 3 separate docs:

Task: Translating templates for different locales

• Format data based on locale using pipes
• Prepare templates for translations
• Extract and work with translation files
• Mark plurals and alternates for translation
• Translate plurals and alternate expressions
• See comment in PR about ICU expressions

Task: Localizing your app

• Set up localization
• Merge translations with the app
• Inline at compile-time
• Runtime ?
• Merge translated libraries used in the app
• Deploy app for multiple locales

Tutorial: Using $localize in your app

• Step-by-step tutorial

Other docs that need updating:

• Creating libraries: Build libraries with translations

For details, see the i18n Documentation Plan.

📷Screenshot

🔥 Exception or Error

🌍 Your Environment

Browser info

Anything else relevant?

[michaelfaith]

Would love to have more documentation on this. Especially handling runtime localization and about building libraries with translations.

[petebacondarwin]

You are basically right in your first description of this issue. This whole area is not documented well (or at all). Hopefully #40317 will begin to resolve this. But we do need to add more to the guides.