docs: add info

Author: SerhiiCho

docs/versions/v3/index.md

@@ -71,7 +71,7 @@ Textwire operates similarly to Go when it comes to mathematical expressions. You
 - Logical OR: `||` (`a || b`)
 
 :::warning Type Mismatching
-Type mismatching is not supported when performing mathematical operations. For example, you cannot add an integer to a float directly. Type conversion is required to match types using conversion functions such as `<your float>.int()`, `<your int>.float()`, etc.
+Type mismatching is not supported when performing mathematical operations. For example, you cannot add an integer to a float directly. Type conversion is required to match types using conversion functions such as `{{ 3 * 2.3.int() }}`, `{{ 3.3 + 2.float() }}`, etc.
 :::
 
 ## Reserved Variable Names

docs/versions/v3/language-elements/expressions.md

@@ -43,10 +43,36 @@ You can use infix expressions to perform arithmetic operations. Example:
     <li>{{ x * y }}</li> {{-- Multiplication --}}
     <li>{{ x / y }}</li> {{-- Division --}}
     <li>{{ x % y }}</li> {{-- Modulo --}}
+    <li>{{ x == y }}</li> {{-- Equality --}}
+    <li>{{ x != y }}</li> {{-- Inequality --}}
+    <li>{{ x && y }}</li> {{-- Logical AND --}}
+    <li>{{ x || y }}</li> {{-- Logical OR --}}
     <li>{{ (x + 2) / (y * (4 - c)) }}</li> {{-- Grouped expressions --}}
 </ul>
 ```
 
+### Infix Operators
+
+| Operator | Description      | Left/Right types             |
+| -------- | ---------------- | ---------------------------- |
+| `==`     | Equal            | `any`                        |
+| `!=`     | Not equal        | `any`                        |
+| `&&`     | Logical AND      | `any`                        |
+| `\|\|`   | Logical OR       | `any`                        |
+| `%`      | Modulo           | `integer`                    |
+| `+`      | Plus             | `integer`, `float`, `string` |
+| `-`      | Minus            | `integer`, `float`           |
+| `*`      | Multiply         | `integer`, `float`           |
+| `/`      | Divide           | `integer`, `float`           |
+| `>`      | Greater          | `integer`, `float`           |
+| `<`      | Less             | `integer`, `float`           |
+| `>=`     | Greater or equal | `integer`, `float`           |
+| `<=`     | Less or equal    | `integer`, `float`           |
+
+### Important Notes
+
+- **String concatenation.** Use `+` operator to concatenate strings. Example: <code v-pre>{{ "Hello, " + name }}</code> will result in `Hello, {name}`.
+
 ## Postfix
 
 You can use postfix expressions to increment or decrement a variable. Example:
@@ -56,6 +82,13 @@ You can use postfix expressions to increment or decrement a variable. Example:
 <span>{{ x-- }}</span> {{-- Decrement --}}
 ```
 
+### Postrix Operators
+
+| Operator | Description | Left/Right types   |
+| -------- | ----------- | ------------------ |
+| `++`     | Increment   | `integer`, `float` |
+| `--`     | Decrement   | `integer`, `float` |
+
 ## Comparison
 
 Comparison expressions produce a boolean value. Example:
@@ -66,18 +99,19 @@ Comparison expressions produce a boolean value. Example:
 @end
 ```
 
-### Supported Operators
+### Comparison Operators
 
-All supported operators are listed in the table below:
+| Operator | Description      | Left/Right types   |
+| -------- | ---------------- | ------------------ |
+| `==`     | Equal            | `any`              |
+| `!=`     | Not equal        | `any`              |
+| `>`      | Greater          | `integer`, `float` |
+| `<`      | Less             | `integer`, `float` |
+| `>=`     | Greater or equal | `integer`, `float` |
+| `<=`     | Less or equal    | `integer`, `float` |
 
-| Operator | Description      |
-| -------- | ---------------- |
-| `==`     | Equal            |
-| `!=`     | Not equal        |
-| `>`      | Greater          |
-| `<`      | Less             |
-| `>=`     | Greater or equal |
-| `<=`     | Less or equal    |
+- **Any type for equality operators.** Unlike Go, in Textwire, operators `==`, `!=`, `&&` and `||` can be used with any types on left and right.
+- **Compare arrays and objects.** Use `==` and `!=` to deeply compare arrays and objects. Example: <code v-pre>{{ [1, 2] == [1, 2] }}</code> will result in `true` because both arrays have the same elements in the same order. Similarly, <code v-pre>{{ { name: "Chiori" } == { name: "Chiori" } }}</code> will also result in `true` because both objects have the same key-value pairs. It works for deeply nested arrays and objects as well.
 
 ## Function Calls