merge with upstream/master

Author: shamansir

.gitignore

@@ -7,5 +7,8 @@
 /site/ru
 /site/en
 /site/zh
+/site/en
+/site/fi
+/site/tr
 *.md~
 *.src.md

doc/en/function/this.md

@@ -79,7 +79,7 @@ local variable inside of `method` which refers to `Foo`.
         test();
     }
 
-`that` is just a normal name, but it is commonly used for the reference to an 
+`that` is just a normal variable name, but it is commonly used for the reference to an 
 outer `this`. In combination with [closures](#function.closures), it can also 
 be used to pass `this` values around.
 
@@ -91,7 +91,7 @@ Another thing that does **not** work in JavaScript is function aliasing, that is
     var test = someObject.methodTest;
     test();
 
-Due to the first case `test` now acts like like a plain function call; therefore,
+Due to the first case `test` now acts like a plain function call; therefore,
 `this` inside it will no longer refer to `someObject`.
 
 While the late binding of `this` might seem like a bad idea at first, it is in 

doc/en/index.json

@@ -6,12 +6,7 @@
         {
             "title": "Intro",
             "dir": "intro",
-            "articles": [
-                "authors",
-                "contributors",
-                "hosting",
-                "license"
-            ]
+            "articles": []
         },
         {
             "title": "Objects",

doc/en/intro/authors.md

@@ -11,5 +11,37 @@ of the language is strongly recommended in order to understand the topics covere
 in this guide. In order to learn the basics of the language, please head over to 
 the excellent [guide][1] on the Mozilla Developer Network.
 
-[1]: https://developer.mozilla.org/en/JavaScript/Guide
+## The Authors
+
+This guide is the work of two lovely [Stack Overflow][2] users, [Ivo Wetzel][3]
+(Writing) and [Zhang Yi Jiang][4] (Design).
+
+## Contributors
+
+ - [Caio Romão][5] (Spelling corrections)
+ - [Andreas Blixt][6] (Language corrections)
+
+## Hosting
 
+JavaScript Garden is hosted on GitHub, but [Cramer Development][7] supports us
+with a mirror at [JavaScriptGarden.info][8].
+
+## License
+
+JavaScript Garden is published under the [MIT license][9] and hosted on
+[GitHub][10]. If you find errors or typos please [file an issue][11] or a pull 
+request on the repository. You can also find us in the [JavaScript room][12] on
+Stack Overflow chat. 
+
+[1]: https://developer.mozilla.org/en/JavaScript/Guide
+[2]: http://stackoverflow.com/
+[3]: http://stackoverflow.com/users/170224/ivo-wetzel
+[4]: http://stackoverflow.com/users/313758/yi-jiang
+[5]: https://github.com/caio
+[6]: https://github.com/blixt
+[7]: http://cramerdev.com/
+[8]: http://javascriptgarden.info/
+[9]: https://github.com/BonsaiDen/JavaScript-Garden/blob/next/LICENSE
+[10]: https://github.com/BonsaiDen/JavaScript-Garden
+[11]: https://github.com/BonsaiDen/JavaScript-Garden/issues
+[12]: http://chat.stackoverflow.com/rooms/17/javascript

doc/en/intro/contributors.md

@@ -0,0 +1,25 @@
+## `Array`-konstruktori
+
+`Array`-oletuskonstruktorin käytös ei ole lainkaan yksiselitteistä. Tämän vuoksi suositellaankin, että konstruktorin sijasta käytetään literaalinotaatiota `[]`.
+
+    [1, 2, 3]; // Tulos: [1, 2, 3]
+    new Array(1, 2, 3); // Tulos: [1, 2, 3]
+
+    [3]; // Tulos: [3]
+    new Array(3); // Tulos: []
+    new Array('3') // Tulos: ['3']
+
+Mikäli `Array`-konstruktorille annetaan vain yksi argumentti ja se on tyypiltään `Number`, konstruktori palauttaa uuden *harvan* taulukon, jonka `length`-attribuutti on asetettu annetun numeron mukaisesti. On tärkeää huomata, että **ainoastaan** `length` asetetaan tällä tavoin, todellisia taulukon indeksejä ei alusteta.
+
+    var arr = new Array(3);
+    arr[1]; // undefined
+    1 in arr; // false, indeksiä ei ole alustettu
+
+Tämä on käytännöllistä vain harvoin, kuten merkkijonon toiston tapauksessa. Tällöin voidaan välttää `for-luupin` käyttämistä.
+
+    new Array(count + 1).join(stringToRepeat);
+
+### Yhteenveto
+
+`Array`-konstruktorin käyttöä tulee käyttää niin paljon kuin suinkin mahdollista. Sen sijaan on suositeltavaa käyttää literaalinotaatiota. Literaalit ovat lyhyempiä ja niiden syntaksi on selkeämpi. Tämän lisäksi ne tekevät koodista luettavampaa.
+

doc/en/intro/hosting.md

@@ -0,0 +1,40 @@
+## Taulukon iterointi ja attribuutit
+
+Vaikka taulukot ovatkin JavaScript-olioita, niiden tapauksessa ei välttämättä kannata käyttää [`for in loop`](#object.forinloop)-luuppia. Pikemminkin tätä tapaa tulee **välttää**.
+
+> **Huomio:** JavaScript-taulukot **eivät ole** *assosiatiivisia*. JavaScriptissa ainoastaan [oliot](#object.general) ovat avain-arvo-mappauksia. On huomattavaa, että toisin kuin assosiatiiviset taulukot, oliot **eivät** säilytä järjestystään.
+
+`for in`-luuppi iteroi kaikki prototyyppiketjun sisältämät ominaisuudet. Tämän vuoksi tulee käyttää erityistä  [`hasOwnProperty`](#object.hasownproperty)-metodia, jonka avulla voidaan taata, että käsitellään oikeita ominaisuuksia. Tästä johtuen iteroint on jo lähtökohtaisesti jopa **kaksikymmentä** kertaa hitaampaa kuin normaalin `for`-luupin tapauksessa.
+
+### Iterointi
+
+Taulukkojen tapauksessa paras suorituskyky voidaan saavuttaa käyttämällä klassista `for`-luuppia.
+
+    var list = [1, 2, 3, 4, 5, ...... 100000000];
+    for(var i = 0, l = list.length; i < l; i++) {
+        console.log(list[i]);
+    }
+
+Edelliseen esimerkkiin liittyy yksi mutta. Listan pituus on tallennettu välimuistiin erikseen käyttämällä `l = list.length`-lauseketta.
+
+Vaikka `length`-ominaisuus määritelläänkin taulukossa itsessään, arvon hakeminen sisältää ylimääräisen operaation. Uudehkot JavaScript-ympäristöt **saattavat** optimoida tämän tapauksen. Tästä ei kuitenkaan ole mitään takeita.
+
+Todellisuudessa välimuistin käytön pois jättäminen voi hidastaa luuppia jopa puolella.
+
+### `length`-ominaisuus
+
+`length`-ominaisuuden *getteri* palauttaa yksinkertaisesti taulukon sisältämien alkioiden määrän. Sen *setteriä* voidaan käyttää taulukon **typistämiseen**.
+
+    var foo = [1, 2, 3, 4, 5, 6];
+    foo.length = 3;
+    foo; // [1, 2, 3]
+
+    foo.length = 6;
+    foo; // [1, 2, 3]
+
+Pituuden pienemmäksi asettaminen typistää taulukkoa. Sen kasvattaminen ei kuitenkaan vaikuta mitenkään.
+
+### Yhteenveto
+
+Parhaan suorituskyvyn kannalta on parhainta käyttää tavallista `for`-luuppia ja tallentaa `length`-ominaisuus välimuistiin. `for in`-luupin käyttö taulukon tapauksessa on merkki huonosti kirjoitetusta koodista, joka on altis bugeille ja heikolle suorituskyvylle.
+