Merge remote-tracking branch 'upstream/master'

Author: kreikenbaum

CONTRIBUTING.md

@@ -9,7 +9,7 @@ Thank you for being kind enough to help out!
 
 ## Testing locally
 
-1. Run `npm run build.js` to build
+1. Run `npm run build` to build
 1. Run a webserver from the root of the repo to view
 
 ## Getting changes merged

doc/en/function/closures.md

@@ -36,12 +36,12 @@ Since it is not possible to reference or assign scopes in JavaScript, there is
 interact with it is via the two closures.
 
     var foo = new Counter(4);
-    foo.hack = function() {
+    foo.hackFail = function() {
         count = 1337;
     };
 
 The above code will **not** change the variable `count` in the scope of `Counter`, 
-since `foo.hack` was not defined in **that** scope. It will instead create - or 
+since `foo.hackFail` was not defined in **that** scope. It will instead create - or 
 override - the *global* variable `count`.
 
 ### Closures Inside Loops

doc/en/function/scopes.md

@@ -220,6 +220,7 @@ which, while different in syntax, behave the same way.
     !function(){}()
     +function(){}()
     (function(){}());
+    void function(){}();
     // and so on...
 
 ### In Conclusion

doc/en/object/general.md

@@ -20,7 +20,7 @@ There are a couple of workarounds that can be used to make number literals act
 as objects too.
 
     2..toString(); // the second point is correctly recognized
-    2 .toString(); // note the space left to the dot
+    2 .toString(); // note the space left of the dot
     (2).toString(); // 2 is evaluated first
 
 ### Objects as a Data Type

doc/it/types/casting.md

@@ -25,7 +25,7 @@ una *conversione di tipo* **ovunque** sia possibile.
 Per evitare i problemi appena visti, l'uso
 dell'[operatore di uguaglianza stretta](#types.equality) è **altamente**
 raccomandato. Sebbene questo eviti molti dei comuni problemi, ci sono ancora
-molti ulteriori problemi che possono essere generati dal sistema debolemente
+molti ulteriori problemi che possono essere generati dal sistema debolmente
 tipizzato di JavaScript.
 
 ### Costruttori di tipi interni

doc/it/types/instanceof.md

@@ -34,7 +34,7 @@ esattamente lo stesso oggetto.
 
 ### In conclusione
 
-L'operatore `instanceof` dovrebbe essere usto **solo** quando si ha a che fare
+L'operatore `instanceof` dovrebbe essere usato **solo** quando si ha a che fare
 con oggetti personalizzati creati dal programmatore, che provengono dallo
 stesso contesto JavaScript. Proprio come per l'operatore [`typeof`](#types.typeof),
 ogni altro tipo di utilizzo dovrebbe essere **evitato**.

doc/ru/array/constructor.md

@@ -15,7 +15,7 @@
     arr[1]; // не определён, undefined
     1 in arr; // false, индекс не был установлен
 
-Поведение, которое позволяет изначально установить только размер массива, может пригодиться лишь в нескольких случаях, таких как повторение строк, за счёт чего избегается использование цикла `for loop`.
+Поведение, которое позволяет изначально установить только размер массива, может пригодиться лишь в нескольких случаях, таких как повторение строк, за счёт чего избегается использование цикла `for`.
 
     new Array(count + 1).join(stringToRepeat);
 

doc/ru/object/general.md

@@ -73,7 +73,7 @@
 
     var test = {
         'case': 'Я — ключевое слово, поэтому меня надо записывать строкой',
-        delete: 'Я тоже ключевое слово, так что я' // бросаю SyntaxError
+        delete: 'Я тоже ключевое слово, так что я' // не является ошибкой, бросает SyntaxError только в версиях ECMAScript ниже 5ой версии
     };
 
 Свойства объектов могут записываться как явно символами, так и в виде закавыченных строк. В связи с другим упущением в парсере JavaScript, этот код выбросит `SyntaxError` во всех версиях ранее ECMAScript 5.

doc/ru/object/hasownproperty.md

@@ -16,7 +16,7 @@
     foo.hasOwnProperty('bar'); // false
     foo.hasOwnProperty('goo'); // true
 
-Только используя ｀hasOwnProperty｀ можно гарантировать правильный результат при переборе свойств объекта. И **нет** иного способа для определения свойств, которые определены в *самом* объекте, а не где-то в цепочке его прототипов.
+Только используя `hasOwnProperty` можно гарантировать правильный результат при переборе свойств объекта. И **нет** иного способа для определения свойств, которые определены в *самом* объекте, а не где-то в цепочке его прототипов.
 
 ### `hasOwnProperty` как свойство
 
@@ -38,4 +38,3 @@ JavaScript **не** резервирует свойство с именем `has
 ### Заключение
 
 **Единственным** способом проверить существование свойства у объекта является использование метода `hasOwnProperty`. При этом рекомендуется использовать этот метод в **каждом** [цикле `for in`](#object.forinloop) вашего проекта, чтобы избежать возможных ошибок с ошибочным заимствованием свойств из [прототипов](#object.prototype) родительских объектов. Также вы можете использовать конструкцию `{}.hasOwnProperty.call(...)` на случай, если кто-то вздумает расширить [прототипы](#object.prototype) встроенных объектов.
-

doc/ru/object/prototype.md

@@ -10,17 +10,19 @@
 
 > **Замечание:** В результате выполнения конструкции `Bar.prototype = Foo.prototype` оба объекта будут делить друг с другом **один и тот же** прототип. Так что изменение прототипа одного из объектов повлечёт за собой изменение прототипа другого и наоборот — вряд ли это окажется тем, чего вы ожидали.
 
+> **Замечание:** Для объявления наследования вместо `Bar.prototype = Object.create(Foo.prototype)` можно воспользоваться конструкций `Bar.prototype = new Foo()`, но у нее есть пару недостатков: 1) как правило требуется унаследовать только методы и свойства прототипа, а не создавать для этого новый объект; 2) создание объекта может требовать обязательные аргументы.
+
+> **Примечание:** Метод `Object.create` отсутствует в IE8 и ниже, но его легко реализовать созданием своей такой функции или же можно подключить библиотеку для поддержки старых IE [*es5-shim*][5]
+
     function Foo() {
         this.value = 42;
     }
-    Foo.prototype = {
-        method: function() {}
-    };
+    Foo.prototype.method = function() {}
 
     function Bar() {}
 
-    // Установим значением прототипа Bar новый экземпляр Foo
-    Bar.prototype = new Foo();
+    // Зададим наследование от Foo
+    Bar.prototype = Object.create(Foo.prototype);
     Bar.prototype.foo = 'Hello World';
 
     // Убедимся, что Bar является действующим конструктором
@@ -81,4 +83,5 @@
 [2]: http://en.wikipedia.org/wiki/Monkey_patch
 [3]: http://prototypejs.org/
 [4]: https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/Array/forEach
+[5]: https://github.com/es-shims/es5-shim