Merge pull request vuejs#106 from Alex-Sokolov/master

Свежие правки + одно изменение откатывают

Author: gbezyuk

src/v2/api/index.md

@@ -442,17 +442,15 @@ type: api
 
 ### computed
 
-- **Тип:** `{ [key: string]: Function | { get: Function, set: Function, cache: Boolean } }`
+- **Тип:** `{ [key: string]: Function | { get: Function, set: Function } }`
 
 - **Подробности:**
 
   Вычисляемые свойства, которые будут подмешаны к экземпляру Vue. В геттерах и сеттерах `this` будет указывать на экземпляр Vue.
 
   <p class="tip">Обратите внимание, что __вам не стоит использовать стрелочные функции при определении вычисляемых свойств__ (напр. `aDouble: () => this.a * 2`). Поскольку стрелочные функции связываются с родительским контекстом, `this` не будет указывать на экземпляр Vue, и `this.a` окажется неопределённым.</p>
 
-  Вычисляемые свойства кешируются и повторно вычисляются только при изменении реактивных зависимостей. Обратите внимание, что если определённая зависимость выходит за область видимости экземпляра (т.е не реактивная), то вычисляемое свойство не будет обновляться. В этой ситуации кеширование можно отключить с помощью опции `cache: false`. Тем не менее, так как зависимость не реактивная, её изменение не будет вызывать обновление DOM.
-
-  В большинстве ситуаций `cache: false` не станет идеальным решением. По возможности лучше переносить внешние данные в систему реактивности. Например, если вычисляемое свойство зависит от размера окна, вы можете хранить эту информацию в `data`, а затем использовать событие `resize` чтобы поддерживать значение актуальным. Теперь данные реактивны!
+  Вычисляемые свойства кешируются и повторно вычисляются только при изменении реактивных зависимостей.
 
 - **Пример:**
 
@@ -669,7 +667,7 @@ type: api
 
   Вызывается после того, как виртуальный DOM был обновлён из-за изменения данных.
 
-  DOM компонента уже будет обновлён к моменту вызова этого хука, поэтому можно выполнять зависящие от DOM операции. Старайтесь избегать изменения состояния в этом хуке, чтобы не попасть в бесконечный цикл обновления.
+  DOM компонента будет уже обновлён к моменту вызова этого хука, поэтому вы можете выполнять операции связанные с DOM здесь. Тем не менее, в большинстве случаев старайтесь избегать изменения состояния в этом хуке. Для реагирования на изменение состояния лучше использовать [вычисляемые свойства](#computed) или [отслеживание с помощью watcher](#watch).
 
   **При рендеринге на стороне сервера этот хук не вызывается.**
 

themes/vue/source/js/common.js

@@ -34,23 +34,23 @@
     }
   }
 
-  function escapeCharacters (hash) {
+  function parseRawHash (hash) {
     // Remove leading hash
     if (hash.charAt(0) === '#') {
       hash = hash.substr(1)
     }
 
-    return '#' + CSS.escape(hash)
+    // Escape characthers
+    try {
+      hash = decodeURIComponent(hash)
+    } catch (e) {}
+    return CSS.escape(hash)
   }
 
   function initLocationHashFuzzyMatching () {
-    var rawHash = window.location.hash;
+    var rawHash = window.location.hash
     if (!rawHash) return
-    try {
-      hash = escapeCharacters(decodeURIComponent(rawHash))
-    } catch(e) {
-      hash = escapeCharacters(rawHash)
-    }
+    var hash = parseRawHash(rawHash)
     var hashTarget = document.getElementById(hash)
     if (!hashTarget) {
       var normalizedHash = normalizeHash(hash)
@@ -63,7 +63,7 @@
         if (distanceA > distanceB) return 1
         return 0
       })
-      window.location.hash = possibleHashes[0]
+      window.location.hash = '#' + possibleHashes[0]
     }
 
     function normalizeHash (rawHash) {