[update] data sorting api and guide

Author: mafanya23

docs/data_collection/api/datacollection_getsortingstates_method.md

@@ -9,7 +9,7 @@ description: You can explore the getSortingStates method of DataCollection in th
 @short: returns an array of objects with the current parameters of sorting applied to the data
 
 :::note
-The method allows sorting data by multiple columns.
+The method allows getting the result of sorting data by multiple columns.
 :::
 
 ## Usage
@@ -31,10 +31,10 @@ An array of objects with the current parameters of sorting applied to the data.
 
 @example:
 const state = grid.data.getSortingStates(); 
-// -> [{by: "country", dir: "desc"}, {by: "population", dir: "desc"},]
+// -> [{by: "country", dir: "desc"}, {by: "population", dir: "desc"}]
 
 @descr:
-The return object includes the following properties:
+The return array contains objects with the following properties:
 
 - `by` - (*string|number*) the id of a data field (a column of Grid) to sort by
 - `dir` - (*"asc"|"desc"*) the direction of sorting: "asc" or "desc"

docs/grid/api/api_overview.md

@@ -21,7 +21,6 @@ description: You can explore the API of Grid in the documentation of the DHTMLX
 | [](grid/api/grid_getcolumn_method.md)         | @getshort(grid/api/grid_getcolumn_method.md)         |
 | [](grid/api/grid_getheaderfilter_method.md)   | @getshort(grid/api/grid_getheaderfilter_method.md)   |
 | [](grid/api/grid_getscrollstate_method.md)    | @getshort(grid/api/grid_getscrollstate_method.md)    |
-| [](grid/api/grid_getsortingstate_method.md)   | @getshort(grid/api/grid_getsortingstate_method.md)   |
 | [](grid/api/grid_getspan_method.md)           | @getshort(grid/api/grid_getspan_method.md)           |
 | [](grid/api/grid_getsummary_method.md)        | @getshort(grid/api/grid_getsummary_method.md)        |
 | [](grid/api/grid_hidecolumn_method.md)        | @getshort(grid/api/grid_hidecolumn_method.md)        |
@@ -191,6 +190,7 @@ description: You can explore the API of Grid in the documentation of the DHTMLX
 | [](grid/api/grid_keynavigation_config.md)   | @getshort(grid/api/grid_keynavigation_config.md)   |
 | [](grid/api/grid_leftsplit_config.md)       | @getshort(grid/api/grid_leftsplit_config.md)       |
 | [](grid/api/grid_multiselection_config.md)  | @getshort(grid/api/grid_multiselection_config.md)  |
+| [](grid/api/grid_multisort_config.md)  	  | @getshort(grid/api/grid_multisort_config.md)       |
 | [](grid/api/grid_resizable_config.md)       | @getshort(grid/api/grid_resizable_config.md)       |
 | [](grid/api/grid_rightsplit_config.md)      | @getshort(grid/api/grid_rightsplit_config.md)      |
 | [](grid/api/grid_rowcss_config.md)          | @getshort(grid/api/grid_rowcss_config.md)          |

docs/grid/api/grid_getsortingstate_method.md

@@ -0,0 +1,30 @@
+---
+sidebar_label: multiSort
+title: JavaScript Grid - multiSort Config 
+description: You can explore the multiSort config of Grid in the documentation of the DHTMLX JavaScript UI library. Browse developer guides and API reference, try out code examples and live demos, and download a free 30-day evaluation version of DHTMLX Suite.
+---
+
+# multiSort
+
+@short: Optional. Enables the possibility of sorting Grid data by multiple columns
+
+:::tip Pro version only
+This functionality is available in the PRO edition only.
+:::
+
+@signature: {'multiSort?: boolean;'}
+
+@default: true
+
+@example:
+const grid = new dhx.Grid("grid_container", {
+    columns: [
+        // columns config
+    ],
+    multiSort: false,
+    data: dataset
+});
+
+@descr:
+
+**Related sample**: [Grid. Sorting by multiple columns (multisorting)](https://snippet.dhtmlx.com/4ej0i3qi)

docs/grid/api/grid_multisort_config.md

@@ -351,25 +351,19 @@ grid.data.sort({
 
 #### Getting the sorting state
 
-To get the current state of sorting data in Grid, use the [](grid/api/grid_getsortingstate_method.md) method. The method returns an object with two attributes:
+To get the current state of sorting data in Grid, use the [`getSortingStates()`](data_collection/api/datacollection_getsortingstates_method.md) method of DataCollection. The method returns an object with the following properties:
 
-<table>
-    <tbody>
-        <tr>
-            <td><b>dir</b></td>
-            <td>(<i>string</i>) the sorting direction (desc, asc)</td>
-        </tr>
-        <tr>
-            <td><b>by</b></td>
-            <td>(<i>string | number</i>) the id of a column that the grid is sorted by</td>
-        </tr>
-    </tbody>
-</table>
-<br/>
+- `by` - (*string|number*) the id of a data field (a column of Grid) to sort by
+- `dir` - (*"asc"|"desc"*) the direction of sorting: "asc" or "desc"
+- `as` - (*function*) a custom function of converting values before comparing
+- `rule` - (*function*) a custom sorting function
+- `smartSorting` - (*boolean*) (if can be applied) specifies whether a sorting rule should be applied each time after changing the data set
 
-~~~js
-const state = grid.getSortingState(); 
-// -> { dir: "desc", by: "country" }
+The method allows getting the result of sorting data by multiple columns.
+
+~~~jsx
+const state = grid.data.getSortingStates(); 
+// -> [{by: "country", dir: "desc"}, {by: "population", dir: "desc"}]
 ~~~
 
 **Related sample**: [Grid. Get sorting state](https://snippet.dhtmlx.com/u2vk3ri3)

docs/grid/usage.md

@@ -6,6 +6,21 @@ description: You can explore how to migrate to newer versions in the documentati
 
 #  Migration to newer versions
 
+9.0 -> 9.1
+-----------
+
+### Grid
+
+The `getSortingState()` method of Grid has been deprecated and replaced with the `getSortingStates()` method of [DataCollection](/data_collection/) and [TreeCollection](/tree_collection/):
+
+~~~jsx title="Before v9.1"
+grid.getSortingState();
+~~~
+
+~~~jsx title="From v9.1"
+grid.data.getSortingStates()[0]; // getting the first (main) sorting state
+~~~
+
 8.4 -> 9.0
 -----------
 

docs/migration.md

@@ -9,7 +9,7 @@ description: You can explore the getSortingStates method of TreeCollection in th
 @short: returns an array of objects with the current parameters of sorting applied to the data
 
 :::note
-The method allows sorting data by multiple columns.
+The method allows getting the result of sorting data by multiple columns.
 :::
 
 ## Usage
@@ -33,7 +33,7 @@ An array of objects with the current parameters of sorting applied to the data.
 const state = component.data.getSortingStates(); 
 
 @descr:
-The return object includes the following properties:
+The return array contains objects with the following properties:
 
 - `by` - (*string|number*) the id of a data field (a column of Grid) to sort by
 - `dir` - (*"asc"|"desc"*) the direction of sorting: "asc" or "desc"

docs/tree_collection/api/treecollection_getsortingstates_method.md

@@ -2496,7 +2496,6 @@ module.exports = {
                       ]
                     },
                     "grid/api/grid_getscrollstate_method",
-                    "grid/api/grid_getsortingstate_method",
                     "grid/api/grid_getspan_method",
                     "grid/api/grid_getsummary_method",
                     "grid/api/grid_hidecolumn_method",
@@ -2631,6 +2630,7 @@ module.exports = {
                     "grid/api/grid_keynavigation_config",
                     "grid/api/grid_leftsplit_config",
                     "grid/api/grid_multiselection_config",
+                    "grid/api/grid_multisort_config",
                     "grid/api/grid_resizable_config",
                     "grid/api/grid_rightsplit_config",
                     "grid/api/grid_rowcss_config",