[update] the setLocale() methods (SVAR-2325)

Author: serhiipylypchuk1991

docs/api/methods/js_kanban_setedit_method.md

@@ -18,15 +18,14 @@ setEdit({ cardId: string | number } | null): void;
 
 ### Parameters
 
-The method can take a *null* value or an object with the fallowing parameter: 
+The method can take a *null* value or an object with the following parameter:
 
 - `cardId` - (required) the ID of the card to be edited
 
 :::note
 To close an editor, call the **setEdit()** method with the ***null*** value
 :::
 
-
 ### Example
 
 ~~~jsx {7}
@@ -39,4 +38,4 @@ const board = new kanban.Kanban("#root", {
 board.setEdit({ cardId: 1 });
 ~~~
 
-**Change log:** The method was added in v1.2
+**Change log:** The method was added in v1.2

docs/api/methods/js_kanban_setlocale_method.md

@@ -22,7 +22,7 @@ setLocale(null | locale?: object): void;
 - `locale` - (optional) the object of data of the new locale to be applied
 
 :::info
-Using this method, you can apply a new locale to Kanban. To reset Kanban to the default locale, call the method without arguments (or with a *null* value)
+Use the `setLocale()` method to apply a new locale to Kanban only. To reset Kanban to the default locale, call the `setLocale()` method without arguments (or with a *null* value). Use the [`toolbar.setLocale()`](api/methods/toolbar_setlocale_method.md) method to apply a new locale to Toolbar only.
 :::
 
 ### Example
@@ -39,6 +39,6 @@ board.setLocale(de);
 board.setLocale(); // or board.setLocale(null);
 ~~~
 
-**Chande log:** The method was updated in v1.2
+**Change log:** The method was updated in v1.2
 
 **Related articles:** [Localization](guides/localization.md)

docs/api/methods/toolbar_setlocale_method.md

@@ -13,16 +13,16 @@ description: You can learn about the setLocale method of Toolbar in the document
 ### Usage
 
 ~~~jsx {}
-setLocale(locale?: object, api?: object): void;
+setLocale(null | locale?: object): void;
 ~~~
 
 ### Parameters
 
-- `locale` - (optional) an object of the locale to be applied to the Toolbar of Kanban
-- `api` - (optional) an object with the internal API of Kanban
+- `null` - (optional) resets Toolbar to the default locale (*English*)
+- `locale` - (optional) the object of new locale data to be applied to the Toolbar
 
 :::info
-The **Toolbar** of Kanban is a separate component. Before changing its locale, be sure that you have already applied the [`setLocale()`](api/methods/toolbar_setlocale_method.md) method to the **Kanban** component
+The **Toolbar** of Kanban is a separate component. Use the `toolbar.setLocale()` method to apply a new locale to Toolbar only. To reset Toolbar to the default locale, call the `toolbar.setLocale()` method without arguments (or with a *null* value). Use the [`kanban.setLocale()`](api/methods/js_kanban_setlocale_method.md) method to apply a new locale to Kanban only.
 :::
 
 ### Example
@@ -35,9 +35,9 @@ const toolbar = new kanban.Toolbar("#toolbar", { api: board.api });
 // apply the "de" locale to Kanban
 board.setLocale(de);
 // apply the "de" locale to the Toolbar
-toolbar.setLocale(de, board.api);
+toolbar.setLocale(de);
 ~~~
 
-**Chande log:** The **api** parameter was added in v1.5.7
+**Change log:** The **api** parameter was deprecated in v1.6
 
 **Related articles:** [Localization](guides/localization.md)

docs/guides/localization.md

@@ -32,6 +32,7 @@ const en = {
         "Add new row": "Add new row",
         "Add new column": "Add new column",
         "Add new card": "Add new card",
+        "Add new card...": "Add new card...",
         "Edit card": "Edit card",
         Edit: "Edit",
 
@@ -76,7 +77,7 @@ const en = {
         "Would you like to delete this comment?":
             "Would you like to delete this comment?",
         "Would you like to delete this card?":
-            "Would you like to delete this card?",
+            "Would you like to delete this card?"
     },
     calendar: { // translations and settings of the calendar
         monthFull: [

docs/news/whats_new.md

@@ -54,6 +54,9 @@ Released on November 13, 2024
         - The method doesn't change themes (use the new [`setTheme()`](../../api/methods/js_kanban_settheme_method) method instead)
         - The method doesn't destroy Kanban datastore. You don't need to recreate event listeners and reattach Toolbar to Kanban
 
+    - The [`setLocale()`](../../api/methods/js_kanban_setlocale_method) method doesn't destroy Kanban datastore. You don't need to recreate event listeners and reattach Toolbar to Kanban
+    - The `api` parameter of the Toolbar [`setLocale()`](../../api/methods/toolbar_setlocale_method) method was deprecated
+
 ### Fixes
 
 - A comment in progress of editing can be removed and text area for new comments disappears