docs: add more info

Author: SerhiiCho

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

@@ -281,9 +281,8 @@ In this example, both default and named slots are used within a single component
 
 ### Important Notes
 
-1. Defining multiple slots with the same name in a single component will result in an error.
-2. Defining multiple default slots in a single component will result in an error.
-3. If you provide an empty string as a slot name, it will act as default slot. `@slot` and `@slot('')` act the same.
+- Defining multiple default slots or named slots with the same name in a single component will result in an error.
+- If you provide an empty string as a slot name, it will act as default slot. `@slot` and `@slot('')` act the same.
 
 ## @dump
 

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

@@ -5,15 +5,14 @@ description: You can find here all the information about expressions in Textwire
 
 # Expressions
 
-- [Ternary expressions](#ternary-expressions) <code v-pre>{{ x ? y : z }}</code>
-- [Prefix expressions](#prefix-expressions) <code v-pre>{{ !x` or `-x }}</code>
-- [Infix expressions](#infix-expressions) <code v-pre>{{ x * (y + 3) }}</code>
-- [Postfix expressions](#postfix-expressions) <code v-pre>{{ x++ }}</code> or <code v-pre>{{ x-- }}</code>
-- [Comparison expressions](#comparison-expressions) <code v-pre>{{ x == y }}</code>
+- [Ternary](#ternary) <code v-pre>{{ x ? y : z }}</code>
+- [Prefix](#prefix) <code v-pre>{{ !x` or `-x }}</code>
+- [Infix](#infix) <code v-pre>{{ x * (y + 3) }}</code>
+- [Postfix](#postfix) <code v-pre>{{ x++ }}</code> or <code v-pre>{{ x-- }}</code>
+- [Comparison](#comparison) <code v-pre>{{ x == y }}</code>
 - [Function calls](#function-calls) <code v-pre>{{ name.split(" ") }}</code>
-- [Variable Declaration](#variable-declaration) <code v-pre>{{ x = 5 }}</code>
 
-## Ternary Expressions
+## Ternary
 You can use ternary expressions to conditionally render content. Here is an example of using ternary expressions:
 
 ```textwire :no-line-numbers
@@ -22,15 +21,15 @@ You can use ternary expressions to conditionally render content. Here is an exam
 
 The advantage of a "ternary expression" over an "if statement" is that it can be used inside of any other expressions.
 
-## Prefix Expressions
+## Prefix
 You can use prefix expressions to negate or invert a boolean value. Here is an example of using prefix expressions:
 
 ```textwire :no-line-numbers
 <span>{{ !isTall ? "Not tall" : "Is tall" }}</span>
 <span>{{ -x }}</span>
 ```
 
-## Infix Expressions
+## Infix
 You can use infix expressions to perform arithmetic operations. Here is an example of using infix expressions:
 
 ```textwire
@@ -44,15 +43,15 @@ You can use infix expressions to perform arithmetic operations. Here is an examp
 </ul>
 ```
 
-## Postfix Expressions
+## Postfix
 You can use postfix expressions to increment or decrement a variable. Here is an example of using postfix expressions:
 
 ```textwire :no-line-numbers
 <span>{{ x++ }}</span> <!-- Increment -->
 <span>{{ x-- }}</span> <!-- Decrement -->
 ```
 
-## Comparison Expressions
+## Comparison
 Comparison expressions produce a boolean value. Here is an example of using comparison expressions:
 
 ```textwire :no-line-numbers
@@ -85,19 +84,4 @@ Here is an example of using function calls:
 {{ name.split(" ") }}
 ```
 
-> You can read more detail about built-in functions on the [Built-in Functions](/v3/functions/guide) page.
-
-## Variable Declaration
-
-You can assign and declare variables by using the `=` operator. Here is an example of declaring variables:
-
-```textwire :no-line-numbers
-{{ x = 5 }}
-{{ x = 10 }}
-```
-
-You cannot assign values to variables of a different type. For example, you cannot do <code v-pre>{{ x = "Hello"; x = 3 }}</code> because `x` is a string and then you are trying to assign an integer to it. In Textwire, you don't need to declare type of a variable, it will be automatically inferred from the value that you assign to it.
-
-:::tip Declaration Has No Output
-Variable declaration statements are not expressions! They don't return any value and can't be used inside of other expressions. Therefore, they don't print anything to the output.
-:::
+You can read more detail about built-in functions on the [Functions Guide](/v3/functions/guide) page.

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

@@ -20,7 +20,11 @@ You can use string literals and concatenate them with other strings. You can use
 {{ "Hello" + 'World!' }}
 ```
 
-> When you print a string, it will be automatically escaped. If you want to print a string without escaping it, you can use the [raw()](/v3/functions/str#raw) function on strings. Example: <code v-pre>{{ "<h1>Test</h1>".raw() }}</code>
+When you print a string, it will be automatically escaped. If you want to print a string without escaping it, you can use the [raw()](/v3/functions/str#raw) function on strings. Example:
+
+```textwire :no-line-numbers
+{{ "<h1>Test</h1>".raw() }}
+```
 
 ## Integer
 You can use integer literals and perform arithmetic operations with them. Here is an example of using integer literals:

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

@@ -7,6 +7,7 @@ description: Learn about trailing commas and comments in Textwire, including how
 
 - [Trailing commas](#trailing-commas) <code v-pre>{{ [1, 2, 3,] }}</code>
 - [Comments](#comments) <code v-pre>{{-- This is a Textwire comment --}}</code>
+- [Variable Declaration](#variable-declaration) <code v-pre>{{ x = 5 }}</code>
 
 ## Trailing Commas
 
@@ -34,3 +35,18 @@ You can use comments in Textwire to write notes or to comment out code. Here is
 ```
 
 HTML comment will be displayed in the final HTML output, but Textwire comment will be removed from the final HTML output. It might be useful when you want to comment out some code that you don't want to be displayed in the final HTML output.
+
+## Variable Declaration
+
+You can assign and declare variables by using the `=` operator. Here is an example of declaring variables:
+
+```textwire :no-line-numbers
+{{ x = 5 }}
+{{ x = 10 }}
+```
+
+You cannot assign values to variables of a different type. For example, you cannot do <code v-pre>{{ x = "Hello"; x = 3 }}</code> because `x` is a string and then you are trying to assign an integer to it. In Textwire, you don't need to declare type of a variable, it will be automatically inferred from the value that you assign to it.
+
+:::tip Declaration Has No Output
+Variable declaration statements are not expressions! They don't return any value and can't be used inside of other expressions. Therefore, they don't print anything to the output.
+:::