diff --git a/README.md b/README.md
index 21d6de7..e965f7c 100644
--- a/README.md
+++ b/README.md
@@ -11,6 +11,15 @@ At the moment, the language has the following capabilities:
 - Builtin `printline` function for printing argument to stdout
 - String and numeric literals
 - Arithmetic operations: addition, subtraction, multiplication, division, modulo, power
+- Variables declaration with following types:
+  - `uint`, `int` - for the machine-word size integers
+  - `i8`..`i64` - integers with specified size
+  - `u8`..`u64` - unsigned integers with specified size
+  - `str` - strings
+  - `bool` - boolean
+- Assignments
+
+Working examples of code can be found in `exl/` directory.
 
 
 ## File extensions
diff --git a/README.ru.md b/README.ru.md
index 0307cbd..28d32c5 100644
--- a/README.ru.md
+++ b/README.ru.md
@@ -11,6 +11,15 @@
 - Встроенную функцию `printline` для вывода аргумента в stdout
 - Строковый и числовой литералы
 - Арифметические операции: сложение, вычитание, умножение, деление, модуло, возведение в степень
+- Декларация переменных со следующими типами:
+  - `uint`, `int` - целые числа размером с машинное слово
+  - `i8`..`i64` - целые числа со знаком
+  - `u8`..`u64` - целые числа без знака
+  - `str` - строки
+  - `bool` - булевы
+- Присваивание
+
+Примеры кода лежат в директории `exl/`.
 
 
 ## Расширения файлов