diff --git a/README-EN.md b/README-EN.md
index 9c1476095..36c6e80cb 100644
--- a/README-EN.md
+++ b/README-EN.md
@@ -34,13 +34,31 @@ The OneScript distribution already includes a set of the most commonly used pack
 
 ### Linux ###
 
+#### v2.x (current branch) — .NET 8.0 based ####
+
+Two ZIP archive variants are available:
+
+| Variant                       | Description                                | External dependencies                                                              |
+|-------------------------------|--------------------------------------------|------------------------------------------------------------------------------------|
+| **SCD** (self-contained)      | .NET Runtime is bundled inside the archive | None                                                                               |
+| **FDD** (framework-dependent) | Smaller archive                            | Requires [.NET Runtime 8.0](https://learn.microsoft.com/dotnet/core/install/linux) |
+
+Installation steps:
 - Download the ZIP archive for Linux from the [Releases](https://github.com/EvilBeaver/OneScript/releases) section or from the [official website](https://oscript.io).
 - Extract the archive to a convenient directory.
 - Set executable permissions:
   ```bash
-  chmod +x oscript
+  chmod +x ./oscript
   ```
 
+The FDD variant requires .NET Runtime 8.0 — see installation instructions for your distribution at [learn.microsoft.com/dotnet/core/install/linux](https://learn.microsoft.com/dotnet/core/install/linux).
+
+#### v1.x LTS — deb package (Mono) ####
+
+The LTS branch is distributed as a `.deb` package and runs on Mono. The package automatically installs the minimum required Mono components; however, **the debugger requires `mono-complete`**.
+
+> **Important for debugging on Ubuntu/Debian:** if breakpoints are not being hit, install `mono-complete` from the **official Mono Project repository** (not from the distribution's default repositories). For instructions specific to your system, see the [Mono Project website](https://www.mono-project.com/download/stable/#download-lin).
+
 ### MacOS ###
 
 - Download the ZIP archive for macOS (x64 or arm64) from the [Releases](https://github.com/EvilBeaver/OneScript/releases) section or from the [official website](https://oscript.io).
diff --git a/README.md b/README.md
index 95779d67d..55b917ba8 100644
--- a/README.md
+++ b/README.md
@@ -34,6 +34,16 @@ OneScript позволяет создавать и выполнять текст
 
 ### Linux ###
 
+#### v2.x (текущая ветка) — на базе .NET 8.0 ####
+
+Существуют два варианта ZIP-архива:
+
+| Вариант                       | Описание                         | Внешние зависимости                                                                 |
+|-------------------------------|----------------------------------|-------------------------------------------------------------------------------------|
+| **SCD** (self-contained)      | .NET Runtime уже включён в архив | Нет                                                                                 |
+| **FDD** (framework-dependent) | Более компактный архив           | Требуется [.NET Runtime 8.0](https://learn.microsoft.com/dotnet/core/install/linux) |
+
+Шаги установки:
 - Скачать ZIP-архив для Linux со [страницы релизов](https://github.com/EvilBeaver/OneScript/releases) или с [официального сайта](https://oscript.io).
 - Распаковать архив в удобный каталог.
 - Установить права на выполнение:
@@ -41,6 +51,14 @@ OneScript позволяет создавать и выполнять текст
   chmod +x oscript
   ```
 
+Для FDD-варианта необходим .NET Runtime 8.0 — инструкция по установке на вашем дистрибутиве: [learn.microsoft.com/dotnet/core/install/linux](https://learn.microsoft.com/dotnet/core/install/linux).
+
+#### v1.x LTS — deb-пакет (Mono) ####
+
+LTS-ветка распространяется в виде `.deb`-пакета и работает на базе Mono. Пакет автоматически устанавливает минимально необходимые компоненты Mono, однако **для работы отладчика** требуется `mono-complete`.
+
+> **Важно для отладки на Ubuntu/Debian:** если точки останова не срабатывают, установите `mono-complete` из **официального репозитория Mono Project** (не из репозиториев дистрибутива). Инструкция для вашей системы — на [сайте Mono Project](https://www.mono-project.com/download/stable/#download-lin).
+
 ### MacOS ###
 
 - Скачать ZIP-архив для macOS (x64 или arm64) со [страницы релизов](https://github.com/EvilBeaver/OneScript/releases) или с [официального сайта](https://oscript.io).