diff --git a/docs/guide-ru/rest-resources.md b/docs/guide-ru/rest-resources.md
index ee148e43d0..9cc2f76587 100644
--- a/docs/guide-ru/rest-resources.md
+++ b/docs/guide-ru/rest-resources.md
@@ -50,9 +50,9 @@ http://localhost/users?fields=id,email&expand=profile
 [[yii\db\ActiveRecord::fields()]] возвращает только те атрибуты, которые были объявлены в схеме БД.
 
 Вы можете переопределить `fields()` для того, чтобы добавить, удалить, переименовать или переобъявить поля. Значение,
-возвращаемое `fields()`, должно быть массивом. Его ключи это имена полей, и значения могут быть либо именами
-свойств/атрибутов, либо анонимными функциями, которые возвращают значение соответствующих полей. Если имя атрибута такое же,
-как ключ массива вы можете опустить значение:
+возвращаемое `fields()`, должно быть массивом. Его ключи — это названия полей. Значения могут быть либо именами
+свойств/атрибутов, либо анонимными функциями, которые возвращают значение соответствующих свойств. Когда
+название поля совпадает с именем аттрибута вы можете опустить ключ массива:
 
 ```php
 // явное перечисление всех атрибутов лучше всего использовать когда вы хотите быть уверенным что изменение
@@ -61,11 +61,11 @@ http://localhost/users?fields=id,email&expand=profile
 public function fields()
 {
     return [
-        // название поля совпадает с названием атрибута
+        // название поля совпадает с именем атрибута
         'id',
-        // имя поля "email", атрибут "email_address"
+        // название поля "email", атрибут "email_address"
         'email' => 'email_address',
-        // имя поля "name", значение определяется callback-ом PHP
+        // название поля "name", значение определяется callback-ом PHP
         'name' => function () {
             return $this->first_name . ' ' . $this->last_name;
         },
@@ -77,7 +77,7 @@ public function fields()
 {
     $fields = parent::fields();
 
-    // удаляем не безопасные поля
+    // удаляем небезопасные поля
     unset($fields['auth_key'], $fields['password_hash'], $fields['password_reset_token']);
 
     return $fields;