[update] docs

Author: Victory

docs/api/spreadsheet_sortcells_method.md

@@ -25,14 +25,22 @@ sortCells(cell: string, dir: number): void;
 
 ### Example
 
-~~~jsx {5}
+~~~jsx {6,9}
 const spreadsheet = new dhx.Spreadsheet("spreadsheet", {
-    // config parameters
+    topSplit: 1
 });
 
+// sorts data on the first sheet
 spreadsheet.sortCells("B2:B11", -1);
+
+// sorts data on the Income sheet
+spreadsheet.sortCells("Income!B2:B11", 1);
 ~~~
 
+:::info
+Use the [topSplit](api/spreadsheet_topsplit_config.md) property if you need to exclude the top rows from sorting.
+:::
+
 **Related sample:** [Spreadsheet. Initialization with multiple sheets](https://snippet.dhtmlx.com/ihtkdcoc)
 
 **Related articles:** [Sorting data](working_with_ssheet.md#sorting-data)

docs/assets/sort_col.png

@@ -175,7 +175,7 @@ Check the example in our [snippet tool](https://snippet.dhtmlx.com/wux2b35b).
 				<li><i>number_s</i> - the number of successes in trials;</li>
 				<li><i>trials</i> - the number of independent trials;</li>
 				<li><i>probability_s</i> - the probability of success on each trial;</li>
-				<li><i>cumulative</i> - if TRUE, then BINOM.DIST returns the cumulative distribution function; if FALSE, it returns the probability mass function.</li>
+				<li><i>cumulative</i> - if TRUE, then BINOM.DIST returns the cumulative distribution function; if FALSE (use 0), it returns the probability mass function.</li>
 			</ul></td>
 			<td>Returns the individual term binomial distribution probability.</td>
 		</tr>
@@ -942,6 +942,17 @@ Check the example in our [snippet tool](https://snippet.dhtmlx.com/wux2b35b).
 			</ul></td>
 			<td>Returns the Weibull distribution.</td>
 		</tr>
+		<tr>
+			<td><b>WEIBULL.DIST</b><br>added in v4.3</td>
+			<td>=WEIBULL(x, alpha, beta, cumulative), <br><br> where:
+			<ul>
+				<li><i>x</i> - the value at which the function must be calculated (must be ≥ 0);</li>
+				<li><i>alpha</i> - the alpha parameter to the distribution (must be > 0);</li>
+				<li><i>beta</i> - the beta parameter to the distribution (must be > 0);</li>
+				<li><i>cumulative</i> - the logical (true/false) argument which defines the type of distribution to be used. If True - Weibull cumulative distribution function, if False - Weibull probability density function </li>
+			</ul></td>
+			<td>Returns the Weibull distribution.</td>
+		</tr>
     </tbody>
 </table>
 
@@ -1065,15 +1076,25 @@ Check the example in our [snippet tool](https://snippet.dhtmlx.com/wux2b35b).
 		</tr>
 		<tr>
 			<td><b>VLOOKUP</b><br>added in v4.3</td>
-			<td>=XLOOKUP(lookup_value, lookup_array, return_array, [if_not_found], [match_mode]), <br><br> where:
+			<td>=VLOOKUP(lookup_value, table_array, column_index_num, [range_lookup]), <br><br> where:
+			<ul>
+				<li><i>lookup_value</i> - the value to search for in the first column of a table;</li>
+				<li><i>table_array</i> - the table from which to retrieve a value;</li>
+				<li><i>column_index_num</i> - the column number in the table from which to retrieve a value;</li>
+				<li><i>range_lookup</i> -  optional (1 by default):<br>0 - exact match, 1 - approximate match</li>
+			</ul></td>
+			<td>Looks up a value in a vertical table by matching on the first column</td>
+		</tr>
+		<tr>
+			<td><b>HLOOKUP</b><br>added in v4.3</td>
+			<td>=HLOOKUP(lookup_value, table_array, row_index, [range_lookup]), <br><br> where:
 			<ul>
 				<li><i>lookup_value</i> - the value to search for;</li>
-				<li><i>lookup_array</i> - the array or range to search;</li>
-				<li><i>return_array</i> - the array or range to return;</li>
-				<li><i>if_not_found</i> - optional, if a valid match is not found, returns the [if_not_found] text you supply;</li>
-				<li><i>match_mode</i> -  optional (0 by default):<br>0 - Exact match<br>-1 - Exact match. If not found, returns the next smaller item<br>1 - Exact match. If not found, returns the next larger item</li>
+				<li><i>table_array</i> - the table from which to retrieve a value;</li>
+				<li><i>column_index_num</i> - the row number in the table from which to retrieve a value;</li>
+				<li><i>range_lookup</i> -  optional (1 by default):<br>0 - exact match, 1 - approximate match</li>
 			</ul></td>
-			<td>Searches a range or an array, and then returns the item corresponding to the first match it finds. If no match exists, then XLOOKUP can return the closest (approximate) match.</td>
+			<td>Looks up a value in a horizontal table</td>
 		</tr>
     </tbody>
 </table>

docs/assets/sort_col_menu.png

@@ -10,7 +10,7 @@ description: You can learn about migration in the documentation of the DHTMLX Ja
 
 Version 4.3 brings a new conception of tracking and handling the actions which are performed when you change something in the spreadsheet. 
 
-The new [beforeAction](api/spreadsheet_beforeaction_event.md) and [afterAction](api/spreadsheet_afteraction_event.md) events will fire right before / after an action is executed and indicate which action has been performed. Thus, the new approach allows you to add the necessary logic for several actions at once via using these two events only. For instance: 
+The new [beforeAction](api/spreadsheet_beforeaction_event.md) and [afterAction](api/spreadsheet_afteraction_event.md) events will fire right before / after an action is executed and indicate which action has been performed. Thus, the new approach allows you to add the necessary logic for several actions at once via using only these two events. For instance: 
 
 ~~~js
 spreadsheet.events.on("BeforeAction", (actionName, config) => {

docs/assets/sort_cols.gif

@@ -14,12 +14,16 @@ To sort spreadsheet data by a column, take the following steps:
 
 2\. Choose *Sort* -> *Sort A to Z* or *Sort Z to A*
 
+![Sort column](assets/sort_col.png)
+
 or
 
 1\. Select the necessary column by clicking on its header
 
 2\. Go to: *Data* -> *Sort* -> *Sort A to Z* or *Sort Z to A* in the menu
 
+![Sort column](assets/sort_col_menu.png)
+
 ## Sorting data by a range
 
 To sort spreadsheet data by a separate range, take the following steps:
@@ -29,4 +33,6 @@ To sort spreadsheet data by a separate range, take the following steps:
 2\. Choose one of the two actions:
 
 - Right-click a cell in the selected range and choose *Sort* -> *Sort A to Z* or *Sort Z to A*
-- Or go to: *Data* -> *Sort* -> *Sort A to Z* or *Sort Z to A* in the menu
+- Or go to: *Data* -> *Sort* -> *Sort A to Z* or *Sort Z to A* in the menu
+
+![Sort column](assets/sort_cols.gif)