diff --git a/docs/guide/migrating-yii2-bootstrap.md b/docs/guide/migrating-yii2-bootstrap.md
index 9c19cd0..fe01d40 100644
--- a/docs/guide/migrating-yii2-bootstrap.md
+++ b/docs/guide/migrating-yii2-bootstrap.md
@@ -1,16 +1,16 @@
 Migrating from yii2-bootstrap4
 ==============================
 
-yii2-bootstrap5 is a major rewrite of the entire project (according Bootstrap 5 to Bootstrap 4 migration guide).
-The most notable changes are summarized below:
+yii2-bootstrap5 является серьезной переработкой всего проекта (в соответствии с руководством по миграции с Bootstrap 4 на Bootstrap 5).
+Наиболее заметные изменения кратко изложены ниже:
 
 ## General
 
-* The namespace is `yii\bootstrap5` instead of `yii\bootstrap4`
-* The php compatibility **is limited to** `>=7.0`
-* The close buttons of widgets like [[yii\bootstrap5\Alert|Alert]] or [[yii\bootstrap5|Modal|Modal]] now gets rendered
-  via CSS and does not have any content anymore. So be sure to remove `btn-close` class and set appropriate styles yourself
-  if you override it.
+* Изменение namespace с `yii\bootstrap4` на `yii\bootstrap5`
+* Минимальная совместимая версия php **ограничена** `>=7.0`
+* Кнопки закрытия виджетов, таких как [[yii\bootstrap5\Alert|Alert]] или [[yii\bootstrap5\Modal|Modal]], теперь отображаются
+с помощью CSS и больше не содержат содержимого. Поэтому обязательно удалите класс "btn-close" и самостоятельно установите соответствующие стили, если вы его переопределяли.
+
 
 ## Widgets / Classes
 
@@ -20,8 +20,8 @@ The most notable changes are summarized below:
 
 ### ActiveForm
 
-There is a new constant [[yii\bootstrap5\ActiveForm::LAYOUT_FLOATING]]. It's a 
-[new form layout](https://getbootstrap.com/docs/5.1/forms/floating-labels/) introduced in Bootstrap 5.
+Новая константа [[yii\bootstrap5\ActiveForm::LAYOUT_FLOATING]]. Это
+[new form layout](https://getbootstrap.com/docs/5.1/forms/floating-labels/) введен в Bootstrap 5.
 
 ### Breadcrumbs
 
@@ -41,9 +41,9 @@ There is a new constant [[yii\bootstrap5\ActiveForm::LAYOUT_FLOATING]]. It's a
 
 ### NavBar
 
-There is now the possibility to create an [offcanvas navbar](https://getbootstrap.com/docs/5.1/components/navbar/#offcanvas).
-You can achieve this by setting the `$collapseOptions` to `false` in [[yii\bootstrap5\NavBar|Navbar]] widget and the 
-`$offcanvasOptions` to at least an empty array.
+Теперь есть возможность создать [offcanvas navbar](https://getbootstrap.com/docs/5.1/components/navbar/#offcanvas).
+Вы можете добиться этого, установив для параметра `$collapseOptions` значение `false` в виджете [[yii\bootstrap5\NavBar|Navbar]] и
+`$offcanvasOptions`, значение пустого массива.
 
 ### Tabs