Merge branch 'master' of https://github.com/BonsaiDen/JavaScript-Garden into slovak-translation

Author: Kubo2

CONTRIBUTING.md

@@ -0,0 +1,8 @@
+# Contributing to Javascript Garden
+
+1. We're about Javascript AKA [ECMA script](http://www.ecma-international.org/ecma-262/5.1/) not a specific implementation. So we don't cover issues specific to one environment or interpreter, like browsers or V8 for node.
+1. Micro-performance is out of scope: anything that's not a result of essential algorithmic complexity (e.g O(log n) vs O(n^2)) is down to a specific version of a specific interpreter (see 1).
+1. Please test code examples to ensure they work, there's nothing more confusing than incorrect examples!
+1. Contributing to JS Garden makes you a fantastic person, and Brendan Eich will find you immensely attractive.
+
+Thank you for being kind enough to help out!

doc/en/core/delete.md

@@ -39,7 +39,7 @@ Explicitly set properties can be deleted normally.
     obj.y; // undefined
 
 In the example above, `obj.x` and `obj.y` can be deleted because they have no 
-`DontDelete` atribute. That's why the example below works too.
+`DontDelete` attribute. That's why the example below works too.
 
     // this works fine, except for IE:
     var GLOBAL_OBJECT = this;

doc/en/function/closures.md

@@ -97,7 +97,7 @@ above.
     }
 
 There's yet another way to accomplish this by using `.bind`, which can bind
-a `this` context and arguments to function. It behaves identially to the code
+a `this` context and arguments to function. It behaves identically to the code
 above
 
     for(var i = 0; i < 10; i++) {

doc/en/function/constructors.md

@@ -72,7 +72,7 @@ explicitly return a value.
     new Bar();
     Bar();
 
-Both calls to `Bar` return the same thing, a newly create object that
+Both calls to `Bar` return the same thing, a newly created object that
 has a property called `method`, which is a 
 [Closure](#function.closures).
 

doc/en/other/timeouts.md

@@ -3,8 +3,11 @@
 Since JavaScript is asynchronous, it is possible to schedule the execution of a 
 function using the `setTimeout` and `setInterval` functions.
 
-> **Note:** Timeouts are **not** part of the ECMAScript Standard. They are
-> implemented as part of the [DOM][1].
+> **Note:** Timeouts are **not** part of the ECMAScript standard. They were
+> implemented in [BOM, or DOM Level 0][1], which are never defined nor
+> documented formally. No recommended specification has been published so far,
+> however, they are currently being standardized by [HTML5][2]. Due to this 
+> nature, the implementation may vary from browsers and engines.
 
     function foo() {}
     var id = setTimeout(foo, 1000); // returns a Number > 0
@@ -52,7 +55,7 @@ intervals, result in function calls stacking up.
     function foo(){
         // something that blocks for 1 second
     }
-    setInterval(foo, 1000);
+    setInterval(foo, 100);
 
 In the above code, `foo` will get called once and will then block for one second.
 
@@ -67,7 +70,7 @@ the function itself.
 
     function foo(){
         // something that blocks for 1 second
-        setTimeout(foo, 1000);
+        setTimeout(foo, 100);
     }
     foo();
 
@@ -115,8 +118,7 @@ specifically.
 `setTimeout` and `setInterval` can also take a string as their first parameter.
 This feature should **never** be used because it internally makes use of `eval`.
 
-> **Note:** Since the timeout functions are **not** specified by the ECMAScript
-> standard, the exact workings when a string is passed to them might differ in
+> **Note:** The exact workings when a string is passed to them might differ in
 > various JavaScript implementations. For example, Microsoft's JScript uses
 > the `Function` constructor in place of `eval`.
 
@@ -146,12 +148,14 @@ function that will get called by either of the timeout functions.
 
     // Instead use an anonymous function
     setTimeout(function() {
-        foo(a, b, c);
+        foo(1, 2, 3);
     }, 1000)
 
-> **Note:** While it is also possible to use the syntax 
-> `setTimeout(foo, 1000, a, b, c)`, it is not recommended, as its use may lead
-> to subtle errors when used with [methods](#function.this). 
+> **Note:** While it is also possible to use `setTimeout(foo, 1000, 1, 2, 3)`
+> syntax, it is not recommended, as its use may lead
+> to subtle errors when used with [methods](#function.this).
+> Furthermore, the syntax might not work in some JavaScript implementations.
+> For example, Microsoft's Internet Explorer [does **not** pass the arguments directly to the callback](3).
 
 ### In Conclusion
 
@@ -163,5 +167,6 @@ be passed that then takes care of the actual call.
 Furthermore, the use of `setInterval` should be avoided because its scheduler is not
 blocked by executing JavaScript.
 
-[1]: http://en.wikipedia.org/wiki/Document_Object_Model "Document Object Model"
-
+[1]: http://www.nczonline.net/blog/2009/09/29/web-definitions-dom-ajax-and-more/ "Web definitions: DOM, Ajax, and more"
+[2]: http://www.w3.org/TR/2014/WD-html5-20140617/webappapis.html#timers "6 Web application APIs - HTML5"
+[3]: http://msdn.microsoft.com/en-us/library/ie/ms536753(v=vs.85).aspx "setTimeout method (Internet Explorer)"

doc/es/other/timeouts.md

@@ -134,11 +134,11 @@ function that will get called by either of the timeout functions.
 
     // Instead use an anonymous function
     setTimeout(function() {
-        foo(a, b, c);
+        foo(1, 2, 3);
     }, 1000)
 
 > **Note:** While it is also possible to use the syntax 
-> `setTimeout(foo, 1000, a, b, c)`, it is not recommended, as its use may lead
+> `setTimeout(foo, 1000, 1, 2, 3)`, it is not recommended, as its use may lead
 > to subtle errors when used with [methods](#function.this). 
 
 ### In Conclusion

doc/fi/other/timeouts.md

@@ -34,7 +34,7 @@ Mikäli suoritettava koodi blokkaa katkaisufunktion kutsun, `setInterval` lisä
     function foo(){
         // jotain joka blokkaa sekunnin ajaksi
     }
-    setInterval(foo, 1000);
+    setInterval(foo, 100);
 
 Yllä olevassa koodissa `foo`-funktiota kutsutaan, jonka jälleen se blokkaa sekunnin ajan.
 
@@ -46,7 +46,7 @@ Helpoin ja joustavin tapa on käyttää `setTimeout`-funktiota funktiossa itsess
 
     function foo(){
         // jotain joka blokkaa sekunnin ajaksi
-        setTimeout(foo, 1000);
+        setTimeout(foo, 100);
     }
     foo();
 
@@ -99,10 +99,10 @@ Tämän lisäksi on suositeltavaa olla **käyttämättä** merkkijonoja parametr
 
     // Käytä nimetöntä funktiota sen sijaan
     setTimeout(function() {
-        foo(a, b, c);
+        foo(1, 2, 3);
     }, 1000)
 
-> **Huomio:** Vaikka syntaksi `setTimeout(foo, 1000, a, b, c)` onkin mahdollinen, ei sen käyttöä suositella. Tämä johtuu siitä, että sen käyttö voi johtaa virheisiin erityisesti [metodien](#function.this) kanssa.
+> **Huomio:** Vaikka syntaksi `setTimeout(foo, 1000, 1, 2, 3)` onkin mahdollinen, ei sen käyttöä suositella. Tämä johtuu siitä, että sen käyttö voi johtaa virheisiin erityisesti [metodien](#function.this) kanssa.
 
 ### Yhteenveto
 

doc/hu/other/timeouts.md

@@ -146,10 +146,10 @@ a timeout függvények által meg lesz hívva a későbbiekben.
 
     // Ehelyett csomagoljuk névtelen függvénybe
     setTimeout(function() {
-        foo(a, b, c);
+        foo(1, 2, 3);
     }, 1000)
 
-> **Megjegyzés:** Habár lehetséges a `setTimeout(foo, 1000, a, b, c)` szintaxist
+> **Megjegyzés:** Habár lehetséges a `setTimeout(foo, 1000, 1, 2, 3)` szintaxist
 > használni, mégsem ajánlott, mivel [metódusok](#function.this)  használatakor
 > észrevehetetlen hibákhoz vezethet.
 

doc/it/other/timeouts.md

@@ -52,7 +52,7 @@ con intervalli molto brevi, tradursi in chiamate a funzione che si sovrappongono
     function foo(){
         // qualcosa che blocca per 1 secondo
     }
-    setInterval(foo, 1000);
+    setInterval(foo, 100);
 
 Nel codice precedente, `foo` verrà chiamato una volta e quindi bloccherà per
 un secondo.
@@ -68,7 +68,7 @@ La soluzione più semplice, come anche la più controllabile, è quella di usare
 
     function foo(){
         // qualcosa che blocca per 1 secondo
-        setTimeout(foo, 1000);
+        setTimeout(foo, 100);
     }
     foo();
 
@@ -150,11 +150,11 @@ funzione che verrà chiamata da una delle funzioni di timeout.
 
     // Usare invece una funzione anonima
     setTimeout(function() {
-        foo(a, b, c);
+        foo(1, 2, 3);
     }, 1000)
 
 > **Nota:** mentre è ancora possibile usare la sintassi
-> `setTimeout(foo, 1000, a, b, c)`, non la si raccomanda, dato che il suo
+> `setTimeout(foo, 1000, 1, 2, 3)`, non la si raccomanda, dato che il suo
 > utilizzo potrebbe portare ad errori subdoli quando usata con i
 > [metodi](#function.this).
 

doc/ja/other/timeouts.md

@@ -40,7 +40,7 @@ JavaScriptは非同期なので、`setTimeout`と`setInterval`関数を使って
     function foo(){
         // 1秒おきにブロックの何かを実行
     }
-    setInterval(foo, 1000);
+    setInterval(foo, 100);
 
 上記のコードでは、`foo`が1回呼び出されて、1秒ブロックされます。
 
@@ -52,7 +52,7 @@ JavaScriptは非同期なので、`setTimeout`と`setInterval`関数を使って
 
     function foo(){
         // 1秒ブロックする何か
-        setTimeout(foo, 1000);
+        setTimeout(foo, 100);
     }
     foo();
 
@@ -108,10 +108,10 @@ JavaScriptは非同期なので、`setTimeout`と`setInterval`関数を使って
 
     // 匿名関数を代わりに使用する
     setTimeout(function() {
-        foo(a, b, c);
+        foo(1, 2, 3);
     }, 1000)
 
-> **注意点:** `setTimeout(foo, 1000, a, b, c)`のようなシンタックスを使用する事も
+> **注意点:** `setTimeout(foo, 1000, 1, 2, 3)`のようなシンタックスを使用する事も
 > できますが、[メソッド](#function.this)を使用した際に、分かりにくいエラーが起りえるので
 > 使用はお勧めしません。
 

doc/ko/other/timeouts.md

@@ -34,7 +34,7 @@ JS엔진은 타이머에 설정한 시간(timer resolution)에 따라서 코드
     function foo(){
         // 1초 동안 블럭함.
     }
-    setInterval(foo, 1000);
+    setInterval(foo, 100);
 
 위 코드에서 `foo`함수는 호출될 때마다 1초씩 실행을 지연시킨다.
 
@@ -47,7 +47,7 @@ JS엔진은 타이머에 설정한 시간(timer resolution)에 따라서 코드
 
     function foo(){
         // something that blocks for 1 second
-        setTimeout(foo, 1000);
+        setTimeout(foo, 100);
     }
     foo();
 
@@ -109,10 +109,10 @@ JS엔진은 타이머에 설정한 시간(timer resolution)에 따라서 코드
 
     // 대신 익명 함수를 사용하는 게 좋다.
     setTimeout(function() {
-        foo(a, b, c);
+        foo(1, 2, 3);
     }, 1000)
 
-> **Note:** `setTimeout(foo, 1000, a, b, c)`처럼 사용하는 것도 가능하지만, 이것도 권장하지 않는다. [메소드](#function.this)를 사용할 때 잡아내기 어려운 에러가 날 수 있다.
+> **Note:** `setTimeout(foo, 1000, 1, 2, 3)`처럼 사용하는 것도 가능하지만, 이것도 권장하지 않는다. [메소드](#function.this)를 사용할 때 잡아내기 어려운 에러가 날 수 있다.
 
 ### 결론
 

doc/pl/other/timeouts.md

@@ -53,7 +53,7 @@ szczególnie przy krótkim interwale.
     function foo(){
         // coś co blokuje wykonanie na 1 sekundę 
     }
-    setInterval(foo, 1000);
+    setInterval(foo, 100);
 
 W powyższym kodzie kod `foo` zostanie wywołany tylko raz i zablokuje wywołanie na 
 jedną sekundę.
@@ -69,7 +69,7 @@ wewnątrz wywoływanej funkcji.
 
     function foo(){
         // coś co blokuje wykonanie na 1 sekundę
-        setTimeout(foo, 1000);
+        setTimeout(foo, 100);
     }
     foo();
 
@@ -137,11 +137,11 @@ do funkcji, która ma zostać wywołana przez budzik.
 
     // zamiast tego należy skorzystać z anonimowej funkcji
     setTimeout(function() {
-        foo(a, b, c);
+        foo(1, 2, 3);
     }, 1000)
 
 >**Uwaga:** Mimo że możliwe jest wykorzystanie składni
-> `setTimeout(foo, 1000, a, b, c)`, nie zaleca się korzystania z niej, ponieważ 
+> `setTimeout(foo, 1000, 1, 2, 3)`, nie zaleca się korzystania z niej, ponieważ
 > może to prowadzić do subtelnych błędów podczas wykorzystania [metod](#function.this).
 
 ### Wnioski

doc/ru/appendix/fromtranslators.md

@@ -8,7 +8,7 @@
 
 С другой стороны, [использование `var`](#function.scopes) и грамотная [расстановка точек с запятой](#core.semicolon) — обязательные вещи, халатное отношение к которым никак не может быть оправдано — в осознанном пропуске `var` (если только вы не переопределяете глобальный объект браузера... хотя *зачем*?) или точки с запятой нет никакого смысла.
 
-Относитесь с **мудростью** к тому, что вы пишете — *важно* знать как работает именно ваш код и как это соответствует приведённым в статье тезисам — и уже из этого вы сможете делать вывод, подходит ли вам тот или иной подход или нет. *Важно* знать как работает [прототипное наследование](#object.prototype), но это не так необходимо, если вы используете функциональный подход или пользуетесь какой-либо сторонней библиотекой. Важно помнить о том, что у вас недостаёт какого-либо конкретного знания и что пробел следует заполнить, но если вы не используете в работе эту часть, вы всё равно можете писать хороший код — ну, если у вас есть талант.
+Относитесь с **мудростью** к тому, что вы пишете — *важно* знать, как работает именно ваш код и как это соответствует приведённым в статье тезисам — и уже из этого вы сможете делать вывод, подходит ли вам тот или иной подход или нет. *Важно* знать, как работает [прототипное наследование](#object.prototype), но это не так необходимо, если вы используете функциональный подход или пользуетесь какой-либо сторонней библиотекой. Важно помнить о том, что у вас недостаёт какого-либо конкретного знания и что пробел следует заполнить, но если вы не используете в работе эту часть, вы всё равно можете писать хороший код — ну, если у вас есть талант.
 
-Гонка за оптимизацией — это драматично и правильно, но лучше написать работающий и понятный вам код, а потом уже его оптимизировать и искать узкие места, при необходимости. Оптимизацию необходимо делать, если вы видите явные неудобства для пользователя в тех или иных браузерах или у вас есть супер-крупный проект, которым никогда не мешает оптимизация, или вы работаете с какой-либо сверхтребовательной технологией типа WebGL. Данная документация очень поможет вам в определении этих узких мест.
+Гонка за оптимизацией — это драматично и правильно, но лучше написать работающий и понятный вам код, а потом уже его оптимизировать и искать узкие места при необходимости. Оптимизацию необходимо делать, если вы видите явные неудобства для пользователя в тех или иных браузерах, или у вас один из тех супер-крупных проектов, которым никогда не помешает оптимизация, или вы работаете с какой-либо сверхтребовательной технологией типа WebGL. Данная документация очень поможет вам в определении этих узких мест.
 

doc/ru/core/eval.md

@@ -31,9 +31,9 @@
 
 ### Проблемы с безопасностью
 
-Кроме всего прочего, функция `eval` — это проблема в безопасности, поскольку исполняется **любой** переданный в неё код; **никогда** не следует использовать её со строками из неизвестных или недоверительных источников.
+Кроме всего прочего, функция `eval` — это проблема в безопасности, поскольку исполняется **любой** переданный в неё код; **никогда** не следует использовать её со строками из неизвестных или недоверенных источников.
 
 ### Заключение
 
-Никогда не стоит использовать `eval`: любое применение такого кода поднимает вопросы о качестве его работы, производительности и безопасности. Если вдруг для работы вам необходим `eval`, эта часть должна тут же ставиться под сомнение и **не** должна использоваться в первую очередь — необходимо найти *лучший способ* , которому не требуются вызовы `eval`.
+Никогда не стоит использовать `eval`: любое применение такого кода поднимает вопросы о качестве его работы, производительности и безопасности. Если вдруг для работы вам необходима `eval`, эта часть должна тут же ставиться под сомнение и **не** должна использоваться в первую очередь — необходимо найти *лучший способ*, которому не требуются вызовы `eval`.
 

doc/ru/function/this.md

@@ -38,7 +38,7 @@
 
 Когда мы используем методы `call` или `apply` из `Function.prototype`, то внутри вызываемой функции `this` **явным образом** будет присвоено значение первого передаваемого параметра.
 
-Исходя из этого, в предыдущем примере (строка с `apply`) правило #3 *вызов метода* **не** будет применёно, и `this` внутри `foo` будет присвоено `bar`.
+Исходя из этого, в предыдущем примере (строка с `apply`) правило #3 *вызов метода* **не** будет применено, и `this` внутри `foo` будет присвоено `bar`.
 
 > **Замечание:** `this` **нельзя** использовать внутри литералов `{}` (`Object`) для ссылки на сам объект. Т.е. если мы напишем `var obj = {me: this}`, то `me` не будет ссылаться на `obj`, поскольку `this` присваивается только по одному из пяти описанных правил.