docs(localization): Update localiation topic with new functionality and mark old one as legacy. by skrustev · Pull Request #6236 · IgniteUI/igniteui-docfx

skrustev · 2025-10-14T08:40:07Z

Requires IgniteUI/igniteui-angular-samples#3752

Checklist:

check topic's TOC/menu and paragraph headings
Include TOC topic labels in topic content has a valuable update, it's new or considered as preview\ beta
link to other topics using ../relative/path.md
at the References section at the end of the topic add links to topics, samples, etc
reference API documentation instead of adding a section with API

use valid component names - [Data] Grid, IgxSelectComponent, <igx-combo>
use spell checker tool (VS Code, Grammarly, Microsoft Editor)
add inline code blocks for the names of classes / tags / properties
add language descriptor for the code blocks
check broken links (use browser add-on)
check if sample is working and fully visible in the topic
check if sample is working and fully visible in the StackBlitz
check if code blocks match the code in StackBlitz demo

follow SEO guidelines to fill topic's metadata (SEO guidelines)

do not resolve requested changes (leave that to the reviewer)
add pending-localization label when the review of the PR is done
add a member from the localization team to translate it

…nd mark old one as legacy.

Copilot

Pull request overview

This PR updates the localization documentation to introduce a new recommended localization approach (as of version 20.2.0) while preserving the legacy method. The new approach provides more features with fewer requirements and includes built-in formatting for all locales based on Intl.

Changes:

Introduced new localization system with provideIgniteIntl() and setCurrentI18n() APIs
Added comprehensive documentation for locale settings, formatting options, and resource string management
Marked the previous localization approach as legacy while keeping it functional

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 13 comments.

File	Description
en/components/toc.yml	Marks the localization topic as updated in the table of contents
en/components/grids_templates/column-types.md	Adds note about new formatting options and references new localization topic
en/components/general/localization.md	Major update: adds new localization section with comprehensive documentation and marks old approach as legacy
cspell.json	Adds "subtag" to custom dictionary for spell checking

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot · 2026-02-05T08:29:52Z

+
+#### Angular API
+
+You can use also Angular's built in [LOCALE_ID](https://angular.dev/api/core/LOCALE_ID) token the set the locale for the whole application. The tag provided will work the same way for our components compared to how our API handles.


The sentence 'The tag provided will work the same way for our components compared to how our API handles' is incomplete. It should be 'how our API handles it' or rephrase for clarity.

Suggested change

You can use also Angular's built in [LOCALE_ID](https://angular.dev/api/core/LOCALE_ID) token the set the locale for the whole application. The tag provided will work the same way for our components compared to how our API handles.

You can also use Angular's built-in [LOCALE_ID](https://angular.dev/api/core/LOCALE_ID) token to set the locale for the whole application. The tag provided will work the same way for our components as it does when using our API.

Copilot · 2026-02-05T08:29:54Z

+
+#### Language and formatting
+
+If you would like to set different from the global localization for a component, you can do that be setting the `locale` property. The will affect the language of the resource strings used as well as the formatting, since they are tied together.


Replace 'The will affect' with 'This will affect' to correct the grammar.

Suggested change

If you would like to set different from the global localization for a component, you can do that be setting the `locale` property. The will affect the language of the resource strings used as well as the formatting, since they are tied together.

If you would like to set different from the global localization for a component, you can do that be setting the `locale` property. This will affect the language of the resource strings used as well as the formatting, since they are tied together.

Copilot · 2026-02-05T08:29:55Z

 The appearance of the date portions will be set (e.g. day, month, year) based on [`locale`]({environment:angularApiUrl}/classes/igxgridcomponent.html#locale) format or [`pipeArgs`]({environment:angularApiUrl}/classes/igxcolumncomponent.html#pipeArgs) input. The pipe arguments can be used to specify a custom [date format](https://angular.io/api/common/DatePipe#pre-defined-format-options) or [timezone](https://angular.io/api/common/DatePipe#parameters):

- **format** - The default value for formatting the date is 'mediumDate'. Other available options are 'short', 'long', 'shortDate', 'fullDate', 'longTime', 'fulLTime' and etc. This is a full list of all available [pre-defined format options](https://angular.io/api/common/DatePipe#pre-defined-format-options).
+- **format** - The default value for formatting the date is 'mediumDate'. Other available options are 'short', 'long', 'shortDate', 'fullDate', 'longTime', 'fulLTime' and etc. This is a full list of all available [pre-defined Angular format options](https://angular.io/api/common/DatePipe#pre-defined-format-options) (legacy).


The capitalization in 'fulLTime' is inconsistent. It should be 'fullTime' to match the pattern of other format options.

@copilot sure, can you suggest commit?

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Copilot · 2026-02-05T09:32:01Z

@dkamburov I've opened a new pull request, #6364, to work on those changes. Once the pull request is ready, I'll request review from you.

* Initial plan * fix: correct capitalization of 'fullTime' in column-types.md Co-authored-by: dkamburov <1182001+dkamburov@users.noreply.github.com> --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: dkamburov <1182001+dkamburov@users.noreply.github.com>

docs(localization): Update localiation topic with new functionality a…

b9615fe

…nd mark old one as legacy.

skrustev assigned dkamburov Oct 14, 2025

skrustev added status: awaiting-test do not merge labels Oct 14, 2025

docs(localization): Mark localization topic as new.

d3df856

skrustev added status: in-development and removed status: awaiting-test labels Oct 21, 2025

docs(localization): Restructure topic and add missing link and data.

92ec5d9

skrustev added status: awaiting-test and removed status: in-development do not merge labels Oct 22, 2025

docs(localization): Update topic with latest info. Mark as updated.

fc6487e

dkamburov assigned MarielaTihova Dec 17, 2025

skrustev added 3 commits December 17, 2025 11:49

Merge branch 'vnext' into skrastev/localization

5ca6c81

chore(*): Add ignore word

c8a4d5c

chore(*): Fix lint...

50c354c

MarielaTihova added status: verified and removed status: awaiting-test labels Jan 5, 2026

dkamburov requested a review from Copilot February 5, 2026 08:28

Copilot AI reviewed Feb 5, 2026

View reviewed changes

dkamburov and others added 10 commits February 5, 2026 11:25

Apply suggestion from @Copilot

598d11a

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Apply suggestion from @Copilot

dca70b0

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Apply suggestion from @Copilot

97d0a3d

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Apply suggestion from @Copilot

d09b9f6

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Apply suggestion from @Copilot

1b5222e

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Apply suggestion from @Copilot

dce7858

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Apply suggestion from @Copilot

b8dde7a

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Apply suggestion from @Copilot

92cbd28

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Apply suggestion from @Copilot

4334503

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Apply suggestion from @Copilot

96cfe5e

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Copilot AI mentioned this pull request Feb 5, 2026

Fix capitalization typo in column-types.md format options #6364

Merged

Copilot AI and others added 2 commits February 5, 2026 11:34

chore(localization): revert the localization subheader

ed58a0b

dkamburov approved these changes Feb 5, 2026

View reviewed changes

dkamburov merged commit e51e063 into vnext Feb 5, 2026
5 checks passed

dkamburov deleted the skrastev/localization branch February 5, 2026 15:48

randriova added a commit that referenced this pull request Feb 9, 2026

docs(*): update JA topics for #6358, #6363 and #6236

c0a0dd0

randriova added the status: localized label Feb 9, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

docs(localization): Update localiation topic with new functionality and mark old one as legacy.#6236

docs(localization): Update localiation topic with new functionality and mark old one as legacy.#6236
dkamburov merged 19 commits intovnextfrom
skrastev/localization

skrustev commented Oct 14, 2025 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI Feb 5, 2026

Uh oh!

Uh oh!

Copilot AI Feb 5, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI Feb 5, 2026

Uh oh!

dkamburov Feb 5, 2026

Uh oh!

Copilot AI commented Feb 5, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants


		#### Angular API

		You can use also Angular's built in [LOCALE_ID](https://angular.dev/api/core/LOCALE_ID) token the set the locale for the whole application. The tag provided will work the same way for our components compared to how our API handles.

	You can use also Angular's built in [LOCALE_ID](https://angular.dev/api/core/LOCALE_ID) token the set the locale for the whole application. The tag provided will work the same way for our components compared to how our API handles.
	You can also use Angular's built-in [LOCALE_ID](https://angular.dev/api/core/LOCALE_ID) token to set the locale for the whole application. The tag provided will work the same way for our components as it does when using our API.


		#### Language and formatting

		If you would like to set different from the global localization for a component, you can do that be setting the `locale` property. The will affect the language of the resource strings used as well as the formatting, since they are tied together.

Conversation

skrustev commented Oct 14, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Checklist:

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI Feb 5, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Copilot AI Feb 5, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI Feb 5, 2026

Choose a reason for hiding this comment

Uh oh!

dkamburov Feb 5, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI commented Feb 5, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

skrustev commented Oct 14, 2025 •

edited

Loading