[RU] Updates

docs/ru/actions.md

@@ -25,7 +25,7 @@ const store = new Vuex.Store({
 })
 ```
 
-Обработчики действий получают объект контекста, содержащий те же методы и свойства, что и сам инстанс хранилища, так что вы можете вызвать `context.commit` для инициирования мутации или обратиться к состоянию и геттерам через `context.state` и `context.getters`. Позднее при рассмотрении [Модулей](modules.md) мы увидим, однако, что этот контекст — не то же самое, что инстанс хранилища.
+Обработчики действий получают объект контекста, содержащий те же методы и свойства, что и сам экземпляр хранилища, так что вы можете вызвать `context.commit` для инициирования мутации или обратиться к состоянию и геттерам через `context.state` и `context.getters`. Позднее при рассмотрении [Модулей](modules.md) мы увидим, однако, что этот контекст — не то же самое, что экземпляр хранилища.
 
 На практике для упрощения кода часто используется [деструктуризация аргументов](https://github.com/lukehoban/es6features#destructuring) из ES2015 (особенно при необходимости многократного вызова `commit`):
 
@@ -107,13 +107,13 @@ export default {
   // ...
   methods: {
     ...mapActions([
-      'increment' // проксирует this.increment() в this.$store.dispatch('increment')
+      'increment' // проксирует `this.increment()` в `this.$store.dispatch('increment')`
 
-      // mapActions также поддерживают нагрузку (payloads):
-      'incrementBy' // проксирует this.incrementBy(amount) в this.$store.dispatch('incrementBy', amount)
+      // `mapActions` также поддерживают нагрузку (payloads):
+      'incrementBy' // проксирует `this.incrementBy(amount)` в `this.$store.dispatch('incrementBy', amount)`
     ]),
     ...mapActions({
-      add: 'increment' // проксирует this.add() в this.$store.dispatch('increment')
+      add: 'increment' // проксирует `this.add()` в `this.$store.dispatch('increment')`
     })
   }
 }
@@ -162,14 +162,14 @@ actions: {
 И, в конце концов, используя [async / await](https://tc39.github.io/ecmascript-asyncawait/) — возможности, которые вот-вот станут общедоступны - можно компоновать действия таким образом:
 
 ``` js
-// предположим, что getData() и getOtherData() возвращают промисы
+// предположим, что `getData()` и `getOtherData()` возвращают промисы
 
 actions: {
   async actionA ({ commit }) {
     commit('gotData', await getData())
   },
   async actionB ({ dispatch, commit }) {
-    await dispatch('actionA') // дожидаемся завершения действия actionA
+    await dispatch('actionA') // дожидаемся завершения действия `actionA`
     commit('gotOtherData', await getOtherData())
   }
 }

docs/ru/api.md

@@ -56,7 +56,7 @@ const store = new Vuex.Store({ ...options })
     ```
 
     При определении в модуле
-    
+
     ```
     state,       // при использовании модулей — локальный state модуля
     getters,     // локальные геттеры текущего модуля
@@ -109,7 +109,7 @@ const store = new Vuex.Store({ ...options })
 
     [Подробнее](strict.md)
 
-### Свойства инстанса Vuex.Store
+### Свойства экземпляра Vuex.Store
 
 - **state**
 
@@ -123,7 +123,7 @@ const store = new Vuex.Store({ ...options })
 
     Зарегистрированные геттеры. Только для чтения.
 
-### Методы инстанса Vuex.Store
+### Методы экземпляра Vuex.Store
 
 - **`commit(type: string, payload?: any, options?: Object) | commit(mutation: Object, options?: Object)`**
 

docs/ru/getters.md

@@ -12,7 +12,9 @@ computed: {
 
 Если этот функционал требуется более чем одному компоненту, понадобится либо дублировать функцию, либо выносить её в совместно используемый хелпер и импортировать в нескольких местах. Оба эти подхода далеки от идеала.
 
-Vuex позволяет определять в хранилище "геттеры" (их можно считать вычисляемыми свойствами хранилища). Геттеры получают первым аргументом ссылку на состояние хранилища:
+Vuex позволяет определять в хранилище «геттеры». Вы можете считать их вычисляемыми свойствами для хранилища. Как и вычисляемые свойства, результаты геттера кэшируются, основываясь на своих зависимостях и будут пересчитаны только тогда, когда изменится одна из его зависимостей.
+
+Геттеры получают первым аргументом ссылку на состояние хранилища:
 
 ``` js
 const store = new Vuex.Store({
@@ -100,7 +102,7 @@ export default {
 
 ``` js
 ...mapGetters({
-  // проксируем this.doneCount в store.getters.doneTodosCount
+  // проксируем `this.doneCount` в `store.getters.doneTodosCount`
   doneCount: 'doneTodosCount'
 })
 ```

docs/ru/modules.md

@@ -25,8 +25,8 @@ const store = new Vuex.Store({
   }
 })
 
-store.state.a // -> состояние модуля moduleA
-store.state.b // -> состояние модуля moduleB
+store.state.a // -> состояние модуля `moduleA`
+store.state.b // -> состояние модуля `moduleB`
 ```
 
 ### Локальное состояние модулей
@@ -38,7 +38,7 @@ const moduleA = {
   state: { count: 0 },
   mutations: {
     increment (state) {
-      // state указывает на локальное состояние модуля
+      // `state` указывает на локальное состояние модуля
       state.count++
     }
   },
@@ -248,7 +248,7 @@ store.registerModule(['nested', 'myModule'], {
 
 Иногда нам может потребоваться создать несколько экземпляров модуля, например:
 
-- Создание нескольких хранилищ, которые используются одним модулем;
+- Создание нескольких хранилищ, которые используются одним модулем (например, чтобы [избегать синглетонов в сохранением состояния в SSR](https://ssr.vuejs.org/ru/structure.html#избегайте-синглетонов-с-состоянием) при использовании опции `runInNewContext` в значении `false` или `'once'`);
 - Регистрация модуля несколько раз в одном хранилище.
 
 Если мы используем просто объект для определения состояния модуля, тогда этот объект состояния будет использоваться по ссылке и вызывать загрязнение состояния хранилища / модуля при его мутациях.
@@ -264,4 +264,4 @@ const MyReusableModule = {
   },
   // мутации, действия, геттеры...
 }
-```
+```

docs/ru/mutations.md

@@ -16,7 +16,7 @@ const store = new Vuex.Store({
 })
 ```
 
-Вызывать функцию-обработчик напрямую — нельзя. Это больше похоже на обработку события: "Когда мутация типа `increment` инициирована, вызывается этот обработчик". Чтобы инициировать обработку мутации, необходимо вызвать **store.commit**, указав её тип:
+Вызывать функцию-обработчик напрямую — нельзя. Это больше похоже на обработку события: "Когда мутация типа `increment` инициирована, вызывается этот обработчик". Чтобы инициировать обработку мутации, необходимо вызвать `store.commit`, указав её тип:
 
 ``` js
 store.commit('increment')
@@ -146,13 +146,13 @@ export default {
   // ...
   methods: {
     ...mapMutations([
-      'increment', // this.increment() будет вызывать this.$store.commit('increment')
+      'increment', // `this.increment()` будет вызывать `this.$store.commit('increment')`
 
       // mapMutations также поддерживает нагрузку:
-      'incrementBy' // this.incrementBy(amount) будет вызывать this.$store.commit('incrementBy', amount)
+      'incrementBy' // `this.incrementBy(amount)` будет вызывать `this.$store.commit('incrementBy', amount)`
     ]),
     ...mapMutations({
-      add: 'increment' // this.add() будет вызывать this.$store.commit('increment')
+      add: 'increment' // `this.add()` будет вызывать `this.$store.commit('increment')`
     })
   }
 }

docs/ru/plugins.md

@@ -7,7 +7,7 @@ const myPlugin = store => {
   // вызывается после инициализации хранилища
   store.subscribe((mutation, state) => {
     // вызывается после каждой мутации
-    // мутация передаётся в формате { type, payload }.
+    // мутация передаётся в формате `{ type, payload }`.
   })
 }
 ```
@@ -62,7 +62,7 @@ const myPluginWithSnapshot = store => {
   store.subscribe((mutation, state) => {
     let nextState = _.cloneDeep(state)
 
-    // сравнение prevState и nextState...
+    // сравнение `prevState` и `nextState`...
 
     // сохранение состояния для следующей мутации
     prevState = nextState
@@ -103,8 +103,8 @@ const store = new Vuex.Store({
 const logger = createLogger({
   collapsed: false, // автоматически раскрывать залогированные мутации
   filter (mutation, stateBefore, stateAfter) {
-    // возвращает true если мутация должна быть залогирована
-    // `mutation` это объект { type, payload }
+    // возвращает `true` если мутация должна быть залогирована
+    // `mutation` это объект `{ type, payload }`
     return mutation.type !== "aBlacklistedMutation"
   },
   transformer (state) {
@@ -113,7 +113,7 @@ const logger = createLogger({
     return state.subTree
   },
   mutationTransformer (mutation) {
-    // мутации логируются в формате { type, payload },
+    // мутации логируются в формате `{ type, payload }`,
     // но это можно изменить
     return mutation.type
   }

docs/ru/state.md

@@ -43,7 +43,7 @@ const app = new Vue({
 })
 ```
 
-Указывая опцию `store` для корневого инстанса, мы обеспечиваем доступ к хранилищу всем дочерним компонентам в `this.$store`. Давайте обновим наш пример со счётчиком:
+Указывая опцию `store` для корневого экземпляра, мы обеспечиваем доступ к хранилищу всем дочерним компонентам в `this.$store`. Давайте обновим наш пример со счётчиком:
 
 ``` js
 const Counter = {
@@ -61,7 +61,7 @@ const Counter = {
 Если компонент использует множество свойств или геттеров хранилища, объявление доступа к ним всем вручную может заставить изрядно заскучать, да и код получится многословный. Чтобы обойти эту проблему, можно использовать хелпер `mapState`, автоматически генерирующий вычисляемые свойства, проксирующие доступ к состоянию и геттерам хранилища:
 
 ``` js
-// при использовании модульных систем, необходимо импортировать Vuex.mapState
+// с полной сборкой можно использовать как Vuex.mapState
 import { mapState } from 'vuex'
 
 export default {

docs/ru/testing.md

@@ -72,7 +72,7 @@ export const getAllProducts = ({ commit }) => {
 // и inject-loader, возвращающий фабрику модулей, помогающую
 // подменять зависимости
 import { expect } from 'chai'
-const actionsInjector = require('inject!./actions')
+const actionsInjector = require('inject-loader!./actions')
 
 // создаём поддельную зависимость
 const actions = actionsInjector({
@@ -213,7 +213,7 @@ mocha test-bundle.js
 #### Запуск в браузерах
 
 1. Установите `mocha-loader`
-2. Измените `entry` в приведённой выше конфигурации webpack на `'mocha!babel!./test.js'`.
+2. Измените `entry` в приведённой выше конфигурации Webpack на `'mocha-loader!babel-loader!./test.js'`.
 3. Запустите `webpack-dev-server`, используя эту конфигурацию
 4. Откройте в браузере `localhost:8080/webpack-dev-server/test-bundle`.