diff --git a/docs/guide-ru/README.md b/docs/guide-ru/README.md
index 4ea8d02..e2295c2 100644
--- a/docs/guide-ru/README.md
+++ b/docs/guide-ru/README.md
@@ -25,3 +25,4 @@
 -------------
 
 * [Использование .sass файлов Bootstrap напрямую](topics-sass.md)
+* [Миграция с yii2-bootstrap4](migrating-yii2-bootstrap.md)
diff --git a/docs/guide-ru/asset-bundles.md b/docs/guide-ru/asset-bundles.md
index fb0e1f8..ef34d14 100644
--- a/docs/guide-ru/asset-bundles.md
+++ b/docs/guide-ru/asset-bundles.md
@@ -5,7 +5,8 @@ Bootstrap - это комплексное front-end решение, включа
 
 - [[yii\bootstrap5\BootstrapAsset|BootstrapAsset]] - содержит CSS файлы.
 - [[yii\bootstrap5\BootstrapPluginAsset|BootstrapPluginAsset]] - зависит от [[yii\bootstrap5\BootstrapAsset]], содержащий javascript файлы.
+- [[yii\bootstrap5\BootstrapIconAsset|BootstrapIconAsset]] - содержит иконки.
 
-Конкретные приложения могут потребовать различного использования. Если вам нужны только CSS-стили, то пакета [[yii\bootstrap5\BootstrapAsset]] будет достаточно. Тем не менее, если вы хотите использовать Bootstrap JavaScript, вам необходимо зарегистрировать [[yii\bootstrap5\BootstrapPluginAsset]].
+Конкретные приложения могут потребовать различного использования. Если вам нужны только CSS-стили, то пакета [[yii\bootstrap5\BootstrapAsset]] будет достаточно. Тем не менее, если вы хотите использовать Bootstrap JavaScript, вам необходимо зарегистрировать [[yii\bootstrap5\BootstrapPluginAsset]], если вы хотите использовать Bootstrap Icons, вам необходимо зарегистрировать [[yii\bootstrap5\BootstrapIconAsset|BootstrapIconAsset]].
 
 > Tip: большинство виджетов регистрируются с помощью [[yii\bootstrap5\BootstrapPluginAsset]] автоматически.
diff --git a/docs/guide-ru/installation.md b/docs/guide-ru/installation.md
index be2a8f0..5d1b8d6 100644
--- a/docs/guide-ru/installation.md
+++ b/docs/guide-ru/installation.md
@@ -14,7 +14,7 @@ php composer.phar require --prefer-dist yiisoft/yii2-bootstrap5
 или добавьте
 
 ```
-"yiisoft/yii2-bootstrap": "~1.0.0"
+"yiisoft/yii2-bootstrap5": "~2.0.0"
 ```
 
 в секцию **require** вашего `composer.json`.
diff --git a/docs/guide-ru/migrating-yii2-bootstrap.md b/docs/guide-ru/migrating-yii2-bootstrap.md
new file mode 100644
index 0000000..a9e0012
--- /dev/null
+++ b/docs/guide-ru/migrating-yii2-bootstrap.md
@@ -0,0 +1,50 @@
+Миграция с yii2-bootstrap4
+==============================
+
+yii2-bootstrap5 является серьезной переработкой всего проекта (в соответствии с руководством по миграции с Bootstrap4 на Bootstrap5).
+Наиболее заметные изменения кратко изложены ниже:
+
+## General
+
+* Изменение namespace с `yii\bootstrap4` на `yii\bootstrap5`
+* Минимальная совместимая версия php **ограничена** `>=7.0`
+* Кнопки закрытия виджетов, таких как [[yii\bootstrap5\Alert|Alert]] или [[yii\bootstrap5\Modal|Modal]], теперь отображаются
+с помощью CSS и больше не содержат содержимого. Поэтому обязательно удалите класс "btn-close" и самостоятельно установите соответствующие стили, если вы его переопределяли.
+
+
+## Widgets / Classes
+
+### BaseHtml
+
+### ActiveField
+
+### ActiveForm
+
+Новая константа [[yii\bootstrap5\ActiveForm::LAYOUT_FLOATING]]. Это
+[new form layout](https://getbootstrap.com/docs/5.1/forms/floating-labels/) введен в Bootstrap 5.
+
+### Breadcrumbs
+
+### ButtonDropdown
+
+### ButtonToolbar
+
+### Carousel
+
+### LinkPager
+
+### Modal
+
+Заменить `data-target` и `data-toggle` на `data-bs-target` и `data-bs-toggle`
+
+### Nav
+
+### NavBar
+
+Теперь есть возможность создать [offcanvas navbar](https://getbootstrap.com/docs/5.1/components/navbar/#offcanvas).
+Вы можете добиться этого, установив для параметра `$collapseOptions` значение `false` в виджете [[yii\bootstrap5\NavBar|Navbar]] и
+`$offcanvasOptions`, значение пустого массива.
+
+### Tabs
+
+### ToggleButtonGroup
diff --git a/docs/guide/migrating-yii2-bootstrap.md b/docs/guide/migrating-yii2-bootstrap.md
index b3eafd8..2fd27f8 100644
--- a/docs/guide/migrating-yii2-bootstrap.md
+++ b/docs/guide/migrating-yii2-bootstrap.md
@@ -35,6 +35,8 @@ There is a new constant [[yii\bootstrap5\ActiveForm::LAYOUT_FLOATING]]. It's a
 
 ### Modal
 
+Change `data-target` and `data-toggle` to `data-bs-target` and `data-bs-toggle`
+
 ### Nav
 
 ### NavBar