docs(ru): translation update (#1858)

Co-authored-by: Alex Sokolov <[email protected]>

Author: Alex-Sokolov

docs/ru/README.md

@@ -4,7 +4,7 @@
 
 Vuex — **паттерн управления состоянием + библиотека** для приложений на Vue.js. Он служит централизованным хранилищем данных для всех компонентов приложения с правилами, гарантирующими, что состояние может быть изменено только предсказуемым образом. Vuex интегрируется с официальным расширением [vue-devtools](https://github.com/vuejs/vue-devtools), предоставляя «из коробки» такие продвинутые возможности, как «машину времени» для отладки и экспорт/импорт слепков состояния данных.
 
-### Что такое «паттерн управления состоянием»?
+## Что такое «паттерн управления состоянием»?
 
 Давайте начнём с простого приложения Vue, реализующего счётчик:
 
@@ -58,7 +58,7 @@ new Vue({
 
 ![vuex](/ru/vuex.png)
 
-### Когда следует использовать Vuex?
+## Когда следует использовать Vuex?
 
 Vuex помогает управлять совместно используемым состоянием ценой привнесения новых концепций и вспомогательного кода. Компромисс, когда кратковременная продуктивность страдает на благо долгосрочной.
 

docs/ru/api/README.md

@@ -176,13 +176,16 @@ const store = new Vuex.Store({ ...options });
 
 * `subscribe(handler: Function, options?: Object): Function`
 
-Отслеживание вызова мутаций хранилища. Обработчик `handler` вызывается после каждой мутации и получает в качестве параметров дескриптор мутации и состояние после мутации:
+Отслеживание вызова мутаций хранилища. Обработчик `handler` вызывается после каждой мутации и получает в качестве параметров дескриптор мутации и состояние после мутации.
 
 ```js
-store.subscribe((mutation, state) => {
-  console.log(mutation.type);
-  console.log(mutation.payload);
-});
+const unsubscribe = store.subscribe((mutation, state) => {
+  console.log(mutation.type)
+  console.log(mutation.payload)
+})
+
+// для остановки отслеживания нужно вызвать unsubscribe
+unsubscribe()
 ```
 
 По умолчанию, новый обработчик добавляется в конец цепочки, поэтому он будет выполняться после других обработчиков, добавленных раньше. Это поведение можно переопределить добавив `prepend: true` в `options`, что позволит добавлять обработчик в начало цепочки.
@@ -191,7 +194,7 @@ store.subscribe((mutation, state) => {
 store.subscribe(handler, { prepend: true })
 ```
 
-Для прекращения отслеживания, необходимо вызвать возвращаемую методом функцию.
+Метод `subscribe` возвращает функцию `unsubscribe`, которую требуется вызывать когда отслеживание больше не требуется. Например, можно подписаться на модуль Vuex и прекращать отслеживание при удалении регистрации модуля. Или можно вызвать `subscribe` внутри компонента Vue, а позднее уничтожить компонент. В таких случаях, необходимо вручную останавливать отслеживание.
 
 Чаще всего используется в плагинах. [Подробнее](../guide/plugins.md)
 
@@ -201,13 +204,18 @@ store.subscribe(handler, { prepend: true })
 
 > Добавлено в версии 2.5.0
 
-Отслеживание вызова действий хранилища. Обработчик `handler` вызывается после каждого действия и получает в качестве параметров дескриптор действия и текущее состояние хранилища:
+Отслеживание вызова действий хранилища. Обработчик `handler` вызывается после каждого действия и получает в качестве параметров дескриптор действия и текущее состояние хранилища.
+
+Метод `subscribe` возвращает функцию `unsubscribe`, которую требуется вызывать когда отслеживание больше не требуется. Например, при удалении регистрации модуля Vuex или перед уничтожением компонента Vue.
 
 ```js
-store.subscribeAction((action, state) => {
-  console.log(action.type);
-  console.log(action.payload);
-});
+const unsubscribe = store.subscribeAction((action, state) => {
+  console.log(action.type)
+  console.log(action.payload)
+})
+
+// для остановки отслеживания нужно вызвать unsubscribe
+unsubscribe()
 ```
 
 По умолчанию, новый обработчик добавляется в конец цепочки, поэтому он будет выполняться после других обработчиков, добавленных раньше. Это поведение можно переопределить добавив `prepend: true` в `options`, что позволит добавлять обработчик в начало цепочки.
@@ -216,7 +224,7 @@ store.subscribeAction((action, state) => {
 store.subscribeAction(handler, { prepend: true })
 ```
 
-Для прекращения отслеживания, необходимо вызвать возвращаемую методом функцию.
+Метод `subscribe` возвращает функцию `unsubscribe`, которую требуется вызывать когда отслеживание больше не требуется. Например, можно подписаться на модуль Vuex и прекращать отслеживание при удалении регистрации модуля. Или можно вызвать `subscribe` внутри компонента Vue, а позднее уничтожить компонент. В таких случаях, необходимо вручную останавливать отслеживание.
 
 > Добавлено в версии 3.1.0
 
@@ -237,7 +245,7 @@ store.subscribeAction({
 
 С версии 3.4.0 в `subscribeAction` также можно указывать обработчик `error` для перехвата ошибки, выброшенной при выполнении действия. В качестве третьего аргумента функция получает объект `error`.
 
-``` js
+```js
 store.subscribeAction({
   error: (action, state, error) => {
     console.log(`error action ${action.type}`)

docs/ru/guide/README.md

@@ -8,14 +8,16 @@
 
 2. Нельзя напрямую изменять состояние хранилища. Единственный способ внести изменения — явно **вызвать мутацию**. Это гарантирует, что любое изменение состояния оставляет след и позволяет использовать инструментарий, чтобы лучше понимать ход работы приложения.
 
-### Простейшее хранилище
+## Простейшее хранилище
 
 :::tip ЗАМЕЧАНИЕ
 В примерах кода документации используется синтаксис ES2015. Если вы с ним ещё не знакомы, [сейчас самое время изучить](https://babeljs.io/docs/learn-es2015/)!
 :::
 
 После [установки](../installation.md) Vuex, давайте создадим хранилище. Это довольно просто — необходимо указать начальный объект состояния и некоторые мутации:
 
+### Vuex 3.x (для Vue 2)
+
 ```js
 import Vue from 'vue'
 import Vuex from 'vuex'
@@ -34,6 +36,23 @@ const store = new Vuex.Store({
 })
 ```
 
+### Vuex 4.x (для Vue 3)
+
+```js
+import { createStore } from 'vuex'
+import { createApp } from 'vue'
+
+const store = createStore({
+  state () {
+    return {
+      count: 1
+    }
+  }
+})
+const app = createApp({ /* ваш корневой компонент */ })
+app.use(store)
+```
+
 Теперь можно получить доступ к объекту состояния через `store.state` и вызвать изменение состояния с помощью метода `store.commit`:
 
 ```js

docs/ru/guide/actions.md

@@ -39,7 +39,7 @@ actions: {
 }
 ```
 
-### Диспетчеризация действий
+## Диспетчеризация действий
 
 Действия запускаются методом `store.dispatch`:
 
@@ -98,7 +98,7 @@ actions: {
 
 Таким образом удаётся организовать поток асинхронных операций, записывая побочные эффекты действий в виде мутаций состояния.
 
-### Диспетчеризация действий в компонентах
+## Диспетчеризация действий в компонентах
 
 Диспетчеризировать действия в компонентах можно при помощи `this.$store.dispatch('xxx')` или используя вспомогательную функцию `mapActions`, создающую локальные псевдонимы для действий в виде методов компонента (требуется наличие корневого `$store`):
 
@@ -121,7 +121,7 @@ export default {
 };
 ```
 
-### Композиция действий
+## Композиция действий
 
 Раз действия зачастую асинхронны, то как узнать, что действие уже завершилось? И, что важнее, как быть со связанными между собой действиями при организации более сложных асинхронных потоков?
 

docs/ru/guide/forms.md

@@ -41,7 +41,7 @@ mutations: {
 }
 ```
 
-### Двунаправленные вычисляемые свойства
+## Двунаправленные вычисляемые свойства
 
 Заметно, что получившаяся выше запись — куда многословнее, чем используемая в связке `v-model` с локальным состоянием, да и некоторые полезные возможности `v-model` мы таким образом упускаем. В качестве альтернативы можно предложить использование двунаправленного вычисляемого свойства с сеттером:
 

docs/ru/guide/getters.md

@@ -34,7 +34,7 @@ const store = new Vuex.Store({
 });
 ```
 
-### Стиль обращения как к свойствам
+## Стиль обращения как к свойствам
 
 Геттеры доступны в объекте `store.getters`, и вы можете получить доступ к значениям как свойствам:
 
@@ -69,7 +69,7 @@ computed: {
 
 Обратите внимание, что геттеры, доступ к которым выполняется как к свойствам, будут кэшироваться как часть системы реактивности Vue.
 
-### Стиль обращения как к методам
+## Стиль обращения как к методам
 
 Можно также передавать аргументы геттерам, возвращая функцию. Это например пригодится, когда необходимо возвращать массив по указанному критерию:
 
@@ -88,7 +88,7 @@ store.getters.getTodoById(2); // -> { id: 2, text: '...', done: false }
 
 Обратите внимание, что геттеры, доступ к которым выполняется как к методам, будут запускаться каждый раз при их вызове, а результаты не будут кэшироваться.
 
-### Вспомогательная функция `mapGetters`
+## Вспомогательная функция `mapGetters`
 
 Функция `mapGetters` просто проксирует геттеры хранилища в локальные вычисляемые свойства компонента: