From 31dd609c726dabaf3b2aa878e14d7e191937189f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20=C5=BBuber?= <bajtas@gmail.com>
Date: Thu, 21 Mar 2019 12:20:54 +0100
Subject: [PATCH 01/32] List and keys translation

---
 content/docs/lists-and-keys.md | 133 +++++++++++++++++++++------------
 1 file changed, 87 insertions(+), 46 deletions(-)

diff --git a/content/docs/lists-and-keys.md b/content/docs/lists-and-keys.md
index 78857063c..9b560ce6e 100644
--- a/content/docs/lists-and-keys.md
+++ b/content/docs/lists-and-keys.md
@@ -1,30 +1,29 @@
 ---
 id: lists-and-keys
-title: Lists and Keys
+title: Listy i klucze
 permalink: docs/lists-and-keys.html
 prev: conditional-rendering.html
 next: forms.html
 ---
  
-First, let's review how you transform lists in JavaScript.
- 
-Given the code below, we use the [`map()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map) function to take an array of `numbers` and double their values. We assign the new array returned by `map()` to the variable `doubled` and log it:
+Na początku, przyjrzymy się jak przekształca się listy w JavaScript.
  
+W kodzie poniżej, użyliśmy funkcji [`map()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map) aby wziąć tablicę `liczb`i podwoić och wartość. Następnie przypisujemy nową tablice zwróconą z funkcji `map()` do zmiennej `doubled` i wyświetlamy ją:
 ```javascript{2}
 const numbers = [1, 2, 3, 4, 5];
 const doubled = numbers.map((number) => number * 2);
 console.log(doubled);
 ```
  
-This code logs `[2, 4, 6, 8, 10]` to the console.
+Ten kod wyświetla w konsoli `[2, 4, 6, 8, 10]`.
  
-In React, transforming arrays into lists of [elements](/docs/rendering-elements.html) is nearly identical.
+W Reakcie, przekształcanie tablic do list [elementów](/docs/rendering-elements.html) jest niemalże identyczne
  
-### Rendering Multiple Components {#rendering-multiple-components}
+### Wyświetlanie wielu komponentów {#rendering-multiple-components}
  
-You can build collections of elements and [include them in JSX](/docs/introducing-jsx.html#embedding-expressions-in-jsx) using curly braces `{}`.
+Możesz zbudować kolekcje elementów i [dodać je do JSX](/docs/introducing-jsx.html#embedding-expressions-in-jsx) używając  klamrowych nawiasów `{}`.
  
-Below, we loop through the `numbers` array using the JavaScript [`map()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map) function. We return a `<li>` element for each item. Finally, we assign the resulting array of elements to `listItems`:
+Poniżej, iterujemy tablicę `liczb` używając funkcji [`map()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map) JavaScript. Zwracamy element `<li>` dla każdego elementu tablicy. Na koniec, przypisujemy wynikową tablie do `listItems`:
  
 ```javascript{2-4}
 const numbers = [1, 2, 3, 4, 5];
@@ -33,7 +32,7 @@ const listItems = numbers.map((number) =>
 );
 ```
  
-We include the entire `listItems` array inside a `<ul>` element, and [render it to the DOM](/docs/rendering-elements.html#rendering-an-element-into-the-dom):
+Umieszczamy całą tablicę `listItems` wewnątrz elementu `<ul>` i [wyświetlamy ją w DOM](/docs/rendering-elements.html#rendering-an-element-into-the-dom):
  
 ```javascript{2}
 ReactDOM.render(
@@ -42,15 +41,15 @@ ReactDOM.render(
 );
 ```
  
-[**Try it on CodePen**](https://codepen.io/gaearon/pen/GjPyQr?editors=0011)
+[**Wypróbuj na CodePen**](https://codepen.io/gaearon/pen/GjPyQr?editors=0011)
  
-This code displays a bullet list of numbers between 1 and 5.
+Ten kod wyświetla wypunktowaną listę numerów pomiędzy 1 i 5.
  
-### Basic List Component {#basic-list-component}
+### Podstawowy komponent listy {#basic-list-component}
  
-Usually you would render lists inside a [component](/docs/components-and-props.html).
+Zazwyczaj będziesz chciał wyświetlić listę wewnątrz [komponentu](/docs/components-and-props.html).
  
-We can refactor the previous example into a component that accepts an array of `numbers` and outputs a list of elements.
+Możemy zmienić poprzedni przykład w komponent który akceptuje tablicę `liczb` i zwraca listę elementów.
  
 ```javascript{3-5,7,13}
 function NumberList(props) {
@@ -70,9 +69,9 @@ ReactDOM.render(
 );
 ```
  
-When you run this code, you'll be given a warning that a key should be provided for list items. A "key" is a special string attribute you need to include when creating lists of elements. We'll discuss why it's important in the next section.
+Kiedy uruchomisz ten kod, dostaniesz ostrzeżenie o tym że właściwość klucza powinna zostać dostarczona do elementów listy. "Klucz" jest specjalnym atrybutem o typie łańcucha znaków, który musisz dodać podczas tworzenia elementów listy. O tym dlaczego jest to ważne opowiemy w następnej sekcji.
  
-Let's assign a `key` to our list items inside `numbers.map()` and fix the missing key issue.
+Przypiszmy `klucz` do naszych elementów listy wewnątrz `numbers.map()` czym naprawimy problem z brakującym kluczem.
  
 ```javascript{4}
 function NumberList(props) {
@@ -94,11 +93,11 @@ ReactDOM.render(
 );
 ```
  
-[**Try it on CodePen**](https://codepen.io/gaearon/pen/jrXYRR?editors=0011)
+[**Wypróbuj na CodePen**](https://codepen.io/gaearon/pen/jrXYRR?editors=0011)
  
-## Keys {#keys}
+## Klucze {#keys}
  
-Keys help React identify which items have changed, are added, or are removed. Keys should be given to the elements inside the array to give the elements a stable identity:
+Klucze pomagają Reaktowi zidentyfikować które elementy uległy zmianie, zostały dodane lub usunięte. Klucze powinny zostać nadane elementom wewnątrz tablic aby zyskały stabilną tożsamość:
  
 ```js{3}
 const numbers = [1, 2, 3, 4, 5];
@@ -109,7 +108,7 @@ const listItems = numbers.map((number) =>
 );
 ```
  
-The best way to pick a key is to use a string that uniquely identifies a list item among its siblings. Most often you would use IDs from your data as keys:
+Najlepszym sposobem wyboru klucza jest użycie unikatowego ciągu znaków który jednoznacznie identyfikuje element listy spośród jego rodzeństwa. Jako klucze często będziesz używał identyfikatór (*ang.* IDs) ze swoich danych:
  
 ```js{2}
 const todoItems = todos.map((todo) =>
@@ -119,34 +118,34 @@ const todoItems = todos.map((todo) =>
 );
 ```
  
-When you don't have stable IDs for rendered items, you may use the item index as a key as a last resort:
+Kiedy nie będziesz miał stabilnych identyfikatorów dla wyświetlanych elementów, w skrajnym przypadku możesz użyć indeksu jako klucz:
  
 ```js{2,3}
 const todoItems = todos.map((todo, index) =>
-  // Only do this if items have no stable IDs
+  // Rób to tylko w przypadku gdy elementy nie mają stabilnego identyfikatorów
   <li key={index}>
     {todo.text}
   </li>
 );
 ```
  
-We don't recommend using indexes for keys if the order of items may change. This can negatively impact performance and may cause issues with component state. Check out Robin Pokorny's article for an [in-depth explanation on the negative impacts of using an index as a key](https://medium.com/@robinpokorny/index-as-a-key-is-an-anti-pattern-e0349aece318). If you choose not to assign an explicit key to list items then React will default to using indexes as keys.
+Nie zalecamy używania indeksów jako klucze jeżeli kolejność elementów może ulec zmianie. Może to negatywnie wpłynąć na wydajność i spowodować problemy ze stanem komponentu. Sprawdź artykuł Robin Pokorny na temat [szczegółowego wyjaśnienia negatywnych aspektów używania indeksu jako klucz](https://medium.com/@robinpokorny/index-as-a-key-is-an-anti-pattern-e0349aece318). Jeżeli nie zdecydujesz się jawnie ustawić kluczy dla elementów listy, React domyślnie użyje indeksów jako klucze.
  
-Here is an [in-depth explanation about why keys are necessary](/docs/reconciliation.html#recursing-on-children) if you're interested in learning more.
+Jeżeli chciałbyś dowiedzieć się wiecej, to tutaj znajdziesz [szczegółowe wyjaśnienie dlaczego klucze są niezbędne](/docs/reconciliation.html#recursing-on-children).
  
-### Extracting Components with Keys {#extracting-components-with-keys}
+### Wydrębnianie komponentów z kluczami {#extracting-components-with-keys}
  
-Keys only make sense in the context of the surrounding array.
+Klucze mają sens tylko w kontekście otaczającej tablicy.
  
-For example, if you [extract](/docs/components-and-props.html#extracting-components) a `ListItem` component, you should keep the key on the `<ListItem />` elements in the array rather than on the `<li>` element in the `ListItem` itself.
+Dla przykładu, jeżeli [wyodrębnisz](/docs/components-and-props.html#extracting-components) komponent `ListItem`, powinieneś trzymać klucz na elementach `<ListItem />`wewnątrz tablicy zamiast na elemencie `<li>` wewnątrz elementu `ListItem`.
  
-**Example: Incorrect Key Usage**
+**Przykłaď: Niepoprawne użycie klucza**
  
 ```javascript{4,5,14,15}
 function ListItem(props) {
   const value = props.value;
   return (
-    // Wrong! There is no need to specify the key here:
+    // Źle! Nie ma potrzeby definiowania klucza tutaj:
     <li key={value.toString()}>
       {value}
     </li>
@@ -156,7 +155,7 @@ function ListItem(props) {
 function NumberList(props) {
   const numbers = props.numbers;
   const listItems = numbers.map((number) =>
-    // Wrong! The key should have been specified here:
+    // Źle! Klucz powinien zostać określony w tym miejscu:
     <ListItem value={number} />
   );
   return (
@@ -173,18 +172,18 @@ ReactDOM.render(
 );
 ```
  
-**Example: Correct Key Usage**
+**Przykład: Poprawne użycie klucza**
  
 ```javascript{2,3,9,10}
 function ListItem(props) {
-  // Correct! There is no need to specify the key here:
+  // Dobrze! Nie ma potrzeby ustawiania klucza tutaj:
   return <li>{props.value}</li>;
 }
  
 function NumberList(props) {
   const numbers = props.numbers;
   const listItems = numbers.map((number) =>
-    // Correct! Key should be specified inside the array.
+    // Dobrze! Klucz powinien zostać ustawiony na elementach wewnątrz tablicy.
     <ListItem key={number.toString()}
               value={number} />
   );
@@ -202,13 +201,13 @@ ReactDOM.render(
 );
 ```
  
-[**Try it on CodePen**](https://codepen.io/gaearon/pen/ZXeOGM?editors=0010)
+[**Wypróbuj na CodePen**](https://codepen.io/gaearon/pen/ZXeOGM?editors=0010)
  
-A good rule of thumb is that elements inside the `map()` call need keys.
+Podstawową regułą jest to że elementy wewnątrz wywołania `map()` potrzebują kluczy.
  
-### Keys Must Only Be Unique Among Siblings {#keys-must-only-be-unique-among-siblings}
+### Klucze muszą być unikalne tylko spośród rodzeństwa {#keys-must-only-be-unique-among-siblings}
  
-Keys used within arrays should be unique among their siblings. However they don't need to be globally unique. We can use the same keys when we produce two different arrays:
+Klucze używane wewnątrz tablic powinny być unikalne w kontekście swojego rodzeństwa. Jednakże nie muszą one być unikatowe globalnie. Możemy użyć tych samych kluczy gdy tworzymy dwie różne tablice:
  
 ```js{2,5,11,12,19,21}
 function Blog(props) {
@@ -239,6 +238,7 @@ function Blog(props) {
 const posts = [
   {id: 1, title: 'Hello World', content: 'Welcome to learning React!'},
   {id: 2, title: 'Installation', content: 'You can install React from npm.'}
+];id: 2, title: 'Installation', content: 'You can install React from npm.'}
 ];
 ReactDOM.render(
   <Blog posts={posts} />,
@@ -246,9 +246,50 @@ ReactDOM.render(
 );
 ```
  
-[**Try it on CodePen**](https://codepen.io/gaearon/pen/NRZYGN?editors=0010)
+[**Wypróbuj na CodePen**](https://codepen.io/gaearon/pen/NRZYGN?editors=0010)
+ 
+Klucze służą Reaktowi jako wskazówka, ale nie są one przekazywane do twoich komponentów. Jeżeli potrzebujesz tych wartości w swoim komponencie, przekaż je jawnie poprzez właściwość z inną nazwą:
+ 
+```js{3,4}
+const content = posts.map((post) =>
+  <Post
+    key={post.id}
+    id={post.id}
+    title={post.title} />
+);
+```
+ 
+W powyższym przykładzie, komponent `Post` może odczytać `props.id`, ale nie `props.key`.
+ 
+### Użycie map() wewnątrz JSX {#embedding-map-in-jsx}
+ 
+W poprzednich przykładach zadeklarowaliśmy oddzielną zmienną `listItems` wewnątrz JSX:
+ 
+```js{3-6}
+function NumberList(props) {
+  const numbers = props.numbers;
+  const listItems = numbers.map((number) =>
+    <ListItem key={number.toString()}
+              value={number} />
+  );
+  return (
+    <ul>
+      {listItems}
+    </ul>
+  );
+}
+```
+ 
+JSX pozwala na [wbudowanie każdego wyrażenia](/docs/introducing
+ReactDOM.render(
+  <Blog posts={posts} />,
+  document.getElementById('root')
+);
+```
+ 
+[**Wypróbuj na CodePen**](https://codepen.io/gaearon/pen/NRZYGN?editors=0010)
  
-Keys serve as a hint to React but they don't get passed to your components. If you need the same value in your component, pass it explicitly as a prop with a different name:
+Klucze służą Reaktowi jako wskazówka, ale nie są one przekazywane do twoich komponentów. Jeżeli potrzebujesz tych wartości w swoim komponencie, przekaż je jawnie poprzez właściwość z inną nazwą:
  
 ```js{3,4}
 const content = posts.map((post) =>
@@ -259,11 +300,11 @@ const content = posts.map((post) =>
 );
 ```
  
-With the example above, the `Post` component can read `props.id`, but not `props.key`.
+W powyższym przykładzie, komponent `Post` może odczytać `props.id`, ale nie `props.key`.
  
-### Embedding map() in JSX {#embedding-map-in-jsx}
+### Użycie map() wewnątrz JSX {#embedding-map-in-jsx}
  
-In the examples above we declared a separate `listItems` variable and included it in JSX:
+W poprzednich przykładach zadeklarowaliśmy oddzielną zmienną `listItems` wewnątrz JSX:
  
 ```js{3-6}
 function NumberList(props) {
@@ -280,7 +321,7 @@ function NumberList(props) {
 }
 ```
  
-JSX allows [embedding any expression](/docs/introducing-jsx.html#embedding-expressions-in-jsx) in curly braces so we could inline the `map()` result:
+JSX pozwala na [wbudowanie każdego wyrażenia](/docs/introducing-jsx.html#embedding-expressions-in-jsx) wewnątrz nawiasów klamrowych, dzięki temu możemy użyć wyniku funkcji `map()` bez przypisywania zmiennej:
  
 ```js{5-8}
 function NumberList(props) {
@@ -296,6 +337,6 @@ function NumberList(props) {
 }
 ```
  
-[**Try it on CodePen**](https://codepen.io/gaearon/pen/BLvYrB?editors=0010)
+[**Wypróbuj na CodePen**](https://codepen.io/gaearon/pen/BLvYrB?editors=0010)
  
-Sometimes this results in clearer code, but this style can also be abused. Like in JavaScript, it is up to you to decide whether it is worth extracting a variable for readability. Keep in mind that if the `map()` body is too nested, it might be a good time to [extract a component](/docs/components-and-props.html#extracting-components).
+Czasami dzięki temu kod jest bardziej przejrzysty, jednak ten sposób może być również nadużywany. Tak samo jak w JavaScript, wybór należy do Ciebie czy warto wyodrębnić zmienną aby zwiększyć czytelność. Zapamiętaj że jeżeli in ciało funkcji `map()` jest zbyt zagnieżdżone, to może być dobry czas aby [wyodrębnić komponent](/docs/components-and-props.html#extracting-components).

From 551be34071ecc643d42662d5b141f37c9c77e80c Mon Sep 17 00:00:00 2001
From: Jakub Frej <jfrej@users.noreply.github.com>
Date: Tue, 2 Apr 2019 20:06:09 +0200
Subject: [PATCH 02/32] Update content/docs/lists-and-keys.md

Co-Authored-By: bartlomiejzuber <bajtas@gmail.com>
---
 content/docs/lists-and-keys.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/docs/lists-and-keys.md b/content/docs/lists-and-keys.md
index 9b560ce6e..56c547cf0 100644
--- a/content/docs/lists-and-keys.md
+++ b/content/docs/lists-and-keys.md
@@ -6,7 +6,7 @@ prev: conditional-rendering.html
 next: forms.html
 ---
  
-Na początku, przyjrzymy się jak przekształca się listy w JavaScript.
+Na początku przyjrzymy się, jak przekształca się listy w JavaScripcie.
  
 W kodzie poniżej, użyliśmy funkcji [`map()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map) aby wziąć tablicę `liczb`i podwoić och wartość. Następnie przypisujemy nową tablice zwróconą z funkcji `map()` do zmiennej `doubled` i wyświetlamy ją:
 ```javascript{2}

From d8fb0597e9c031bd15d98afe12563f4c7cc96e8e Mon Sep 17 00:00:00 2001
From: Jakub Frej <jfrej@users.noreply.github.com>
Date: Tue, 2 Apr 2019 20:06:38 +0200
Subject: [PATCH 03/32] Update content/docs/lists-and-keys.md

Co-Authored-By: bartlomiejzuber <bajtas@gmail.com>
---
 content/docs/lists-and-keys.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/docs/lists-and-keys.md b/content/docs/lists-and-keys.md
index 56c547cf0..2ae00b192 100644
--- a/content/docs/lists-and-keys.md
+++ b/content/docs/lists-and-keys.md
@@ -17,7 +17,7 @@ console.log(doubled);
  
 Ten kod wyświetla w konsoli `[2, 4, 6, 8, 10]`.
  
-W Reakcie, przekształcanie tablic do list [elementów](/docs/rendering-elements.html) jest niemalże identyczne
+W Reakcie przekształcanie tablic w listy [elementów](/docs/rendering-elements.html) jest niemalże identyczne.
  
 ### Wyświetlanie wielu komponentów {#rendering-multiple-components}
  

From 1dbf81d41a72bbd01b620a4d57b098438e4e02ba Mon Sep 17 00:00:00 2001
From: Jakub Frej <jfrej@users.noreply.github.com>
Date: Tue, 2 Apr 2019 20:07:02 +0200
Subject: [PATCH 04/32] Update content/docs/lists-and-keys.md

Co-Authored-By: bartlomiejzuber <bajtas@gmail.com>
---
 content/docs/lists-and-keys.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/docs/lists-and-keys.md b/content/docs/lists-and-keys.md
index 2ae00b192..ba168f866 100644
--- a/content/docs/lists-and-keys.md
+++ b/content/docs/lists-and-keys.md
@@ -21,7 +21,7 @@ W Reakcie przekształcanie tablic w listy [elementów](/docs/rendering-elements.
  
 ### Wyświetlanie wielu komponentów {#rendering-multiple-components}
  
-Możesz zbudować kolekcje elementów i [dodać je do JSX](/docs/introducing-jsx.html#embedding-expressions-in-jsx) używając  klamrowych nawiasów `{}`.
+Możesz zbudować kolekcje elementów i [dodać je do JSX](/docs/introducing-jsx.html#embedding-expressions-in-jsx) używając nawiasów klamrowych `{}`.
  
 Poniżej, iterujemy tablicę `liczb` używając funkcji [`map()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map) JavaScript. Zwracamy element `<li>` dla każdego elementu tablicy. Na koniec, przypisujemy wynikową tablie do `listItems`:
  

From d0eef93afa21b9c1504198637a195bcf443a0156 Mon Sep 17 00:00:00 2001
From: Jakub Frej <jfrej@users.noreply.github.com>
Date: Tue, 2 Apr 2019 20:07:38 +0200
Subject: [PATCH 05/32] Update content/docs/lists-and-keys.md

Co-Authored-By: bartlomiejzuber <bajtas@gmail.com>
---
 content/docs/lists-and-keys.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/docs/lists-and-keys.md b/content/docs/lists-and-keys.md
index ba168f866..8b9d38a63 100644
--- a/content/docs/lists-and-keys.md
+++ b/content/docs/lists-and-keys.md
@@ -23,7 +23,7 @@ W Reakcie przekształcanie tablic w listy [elementów](/docs/rendering-elements.
  
 Możesz zbudować kolekcje elementów i [dodać je do JSX](/docs/introducing-jsx.html#embedding-expressions-in-jsx) używając nawiasów klamrowych `{}`.
  
-Poniżej, iterujemy tablicę `liczb` używając funkcji [`map()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map) JavaScript. Zwracamy element `<li>` dla każdego elementu tablicy. Na koniec, przypisujemy wynikową tablie do `listItems`:
+Poniżej iterujemy tablicę liczb `numbers` używając javascriptowej funkcji [`map()`](https://developer.mozilla.org/pl/docs/Web/JavaScript/Referencje/Obiekty/Array/map). Zwracamy element `<li>` dla każdego elementu tablicy. Na koniec przypisujemy wynikową tablicę do `listItems`:
  
 ```javascript{2-4}
 const numbers = [1, 2, 3, 4, 5];

From 9ffe846692bbfc164a16037a1e00a42506972d77 Mon Sep 17 00:00:00 2001
From: Jakub Frej <jfrej@users.noreply.github.com>
Date: Tue, 2 Apr 2019 20:08:18 +0200
Subject: [PATCH 06/32] Update content/docs/lists-and-keys.md

Co-Authored-By: bartlomiejzuber <bajtas@gmail.com>
---
 content/docs/lists-and-keys.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/docs/lists-and-keys.md b/content/docs/lists-and-keys.md
index 8b9d38a63..1d7b5ba05 100644
--- a/content/docs/lists-and-keys.md
+++ b/content/docs/lists-and-keys.md
@@ -43,7 +43,7 @@ ReactDOM.render(
  
 [**Wypróbuj na CodePen**](https://codepen.io/gaearon/pen/GjPyQr?editors=0011)
  
-Ten kod wyświetla wypunktowaną listę numerów pomiędzy 1 i 5.
+Ten kod wyświetla wypunktowaną listę liczb od 1 do 5.
  
 ### Podstawowy komponent listy {#basic-list-component}
  

From 49e70f15fdbb326397874a60f13fe4843fdfe342 Mon Sep 17 00:00:00 2001
From: Jakub Frej <jfrej@users.noreply.github.com>
Date: Tue, 2 Apr 2019 20:08:39 +0200
Subject: [PATCH 07/32] Update content/docs/lists-and-keys.md

Co-Authored-By: bartlomiejzuber <bajtas@gmail.com>
---
 content/docs/lists-and-keys.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/docs/lists-and-keys.md b/content/docs/lists-and-keys.md
index 1d7b5ba05..1d16ae686 100644
--- a/content/docs/lists-and-keys.md
+++ b/content/docs/lists-and-keys.md
@@ -207,7 +207,7 @@ Podstawową regułą jest to że elementy wewnątrz wywołania `map()` potrzebuj
  
 ### Klucze muszą być unikalne tylko spośród rodzeństwa {#keys-must-only-be-unique-among-siblings}
  
-Klucze używane wewnątrz tablic powinny być unikalne w kontekście swojego rodzeństwa. Jednakże nie muszą one być unikatowe globalnie. Możemy użyć tych samych kluczy gdy tworzymy dwie różne tablice:
+Klucze używane wewnątrz tablic powinny być unikalne w kontekście swojego rodzeństwa. Jednakże nie muszą one być niepowtarzalne globalnie. Możemy użyć tych samych kluczy, gdy tworzymy dwie różne tablice:
  
 ```js{2,5,11,12,19,21}
 function Blog(props) {

From 25daac4e92025f0a609d41948f364029fa851875 Mon Sep 17 00:00:00 2001
From: Bartlomiej Zuber <bartlomiej.zuber@outlook.com>
Date: Tue, 2 Apr 2019 20:10:52 +0200
Subject: [PATCH 08/32] removing unnecessary line

---
 content/docs/lists-and-keys.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/content/docs/lists-and-keys.md b/content/docs/lists-and-keys.md
index 1d16ae686..caf089023 100644
--- a/content/docs/lists-and-keys.md
+++ b/content/docs/lists-and-keys.md
@@ -238,7 +238,6 @@ function Blog(props) {
 const posts = [
   {id: 1, title: 'Hello World', content: 'Welcome to learning React!'},
   {id: 2, title: 'Installation', content: 'You can install React from npm.'}
-];id: 2, title: 'Installation', content: 'You can install React from npm.'}
 ];
 ReactDOM.render(
   <Blog posts={posts} />,

From c6b089cbb96f4720f82397570675d97ca05fb7e7 Mon Sep 17 00:00:00 2001
From: Bartlomiej Zuber <bartlomiej.zuber@outlook.com>
Date: Tue, 2 Apr 2019 20:15:35 +0200
Subject: [PATCH 09/32] translation added for strings inside code block

---
 content/docs/lists-and-keys.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/content/docs/lists-and-keys.md b/content/docs/lists-and-keys.md
index caf089023..2830910b2 100644
--- a/content/docs/lists-and-keys.md
+++ b/content/docs/lists-and-keys.md
@@ -236,8 +236,8 @@ function Blog(props) {
 }
  
 const posts = [
-  {id: 1, title: 'Hello World', content: 'Welcome to learning React!'},
-  {id: 2, title: 'Installation', content: 'You can install React from npm.'}
+  {id: 1, title: 'Witaj Świecie', content: 'Witamy uczących się Reacta!'},
+  {id: 2, title: 'Instalacja', content: 'Możesz zainstalować Reacta używając npm.'}
 ];
 ReactDOM.render(
   <Blog posts={posts} />,

From ec82dee2c6a013627ef24047c0626ab2314d4a8f Mon Sep 17 00:00:00 2001
From: Bartlomiej Zuber <bartlomiej.zuber@outlook.com>
Date: Tue, 2 Apr 2019 20:19:13 +0200
Subject: [PATCH 10/32] codepen related text translation

---
 content/docs/lists-and-keys.md | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/content/docs/lists-and-keys.md b/content/docs/lists-and-keys.md
index 2830910b2..2a561ee4b 100644
--- a/content/docs/lists-and-keys.md
+++ b/content/docs/lists-and-keys.md
@@ -41,7 +41,7 @@ ReactDOM.render(
 );
 ```
  
-[**Wypróbuj na CodePen**](https://codepen.io/gaearon/pen/GjPyQr?editors=0011)
+[**Przetestuj kod na CodePen**](https://codepen.io/gaearon/pen/GjPyQr?editors=0011)
  
 Ten kod wyświetla wypunktowaną listę liczb od 1 do 5.
  
@@ -93,7 +93,7 @@ ReactDOM.render(
 );
 ```
  
-[**Wypróbuj na CodePen**](https://codepen.io/gaearon/pen/jrXYRR?editors=0011)
+[**Przetestuj kod na CodePen**](https://codepen.io/gaearon/pen/jrXYRR?editors=0011)
  
 ## Klucze {#keys}
  
@@ -201,7 +201,7 @@ ReactDOM.render(
 );
 ```
  
-[**Wypróbuj na CodePen**](https://codepen.io/gaearon/pen/ZXeOGM?editors=0010)
+[**Przetestuj kod na CodePen**](https://codepen.io/gaearon/pen/ZXeOGM?editors=0010)
  
 Podstawową regułą jest to że elementy wewnątrz wywołania `map()` potrzebują kluczy.
  
@@ -245,7 +245,7 @@ ReactDOM.render(
 );
 ```
  
-[**Wypróbuj na CodePen**](https://codepen.io/gaearon/pen/NRZYGN?editors=0010)
+[**Przetestuj kod na CodePen**](https://codepen.io/gaearon/pen/NRZYGN?editors=0010)
  
 Klucze służą Reaktowi jako wskazówka, ale nie są one przekazywane do twoich komponentów. Jeżeli potrzebujesz tych wartości w swoim komponencie, przekaż je jawnie poprzez właściwość z inną nazwą:
  
@@ -286,7 +286,7 @@ ReactDOM.render(
 );
 ```
  
-[**Wypróbuj na CodePen**](https://codepen.io/gaearon/pen/NRZYGN?editors=0010)
+[**Przetestuj kod na CodePen**](https://codepen.io/gaearon/pen/NRZYGN?editors=0010)
  
 Klucze służą Reaktowi jako wskazówka, ale nie są one przekazywane do twoich komponentów. Jeżeli potrzebujesz tych wartości w swoim komponencie, przekaż je jawnie poprzez właściwość z inną nazwą:
  
@@ -336,6 +336,6 @@ function NumberList(props) {
 }
 ```
  
-[**Wypróbuj na CodePen**](https://codepen.io/gaearon/pen/BLvYrB?editors=0010)
+[**Przetestuj kod na CodePen**](https://codepen.io/gaearon/pen/BLvYrB?editors=0010)
  
 Czasami dzięki temu kod jest bardziej przejrzysty, jednak ten sposób może być również nadużywany. Tak samo jak w JavaScript, wybór należy do Ciebie czy warto wyodrębnić zmienną aby zwiększyć czytelność. Zapamiętaj że jeżeli in ciało funkcji `map()` jest zbyt zagnieżdżone, to może być dobry czas aby [wyodrębnić komponent](/docs/components-and-props.html#extracting-components).

From 10157c21a5f06f7ae136249ff707f52d98751630 Mon Sep 17 00:00:00 2001
From: Jakub Frej <jfrej@users.noreply.github.com>
Date: Tue, 2 Apr 2019 20:20:03 +0200
Subject: [PATCH 11/32] Update content/docs/lists-and-keys.md

Co-Authored-By: bartlomiejzuber <bajtas@gmail.com>
---
 content/docs/lists-and-keys.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/docs/lists-and-keys.md b/content/docs/lists-and-keys.md
index 2830910b2..c9933b41b 100644
--- a/content/docs/lists-and-keys.md
+++ b/content/docs/lists-and-keys.md
@@ -47,7 +47,7 @@ Ten kod wyświetla wypunktowaną listę liczb od 1 do 5.
  
 ### Podstawowy komponent listy {#basic-list-component}
  
-Zazwyczaj będziesz chciał wyświetlić listę wewnątrz [komponentu](/docs/components-and-props.html).
+Zazwyczaj będziesz wyświetlać listy wewnątrz [komponentu](/docs/components-and-props.html).
  
 Możemy zmienić poprzedni przykład w komponent który akceptuje tablicę `liczb` i zwraca listę elementów.
  

From 40335f25ba4d465c978bd7dac07a7e731a1f0b13 Mon Sep 17 00:00:00 2001
From: Jakub Frej <jfrej@users.noreply.github.com>
Date: Tue, 2 Apr 2019 20:20:28 +0200
Subject: [PATCH 12/32] Update content/docs/lists-and-keys.md

Co-Authored-By: bartlomiejzuber <bajtas@gmail.com>
---
 content/docs/lists-and-keys.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/docs/lists-and-keys.md b/content/docs/lists-and-keys.md
index c9933b41b..a5f86e06d 100644
--- a/content/docs/lists-and-keys.md
+++ b/content/docs/lists-and-keys.md
@@ -49,7 +49,7 @@ Ten kod wyświetla wypunktowaną listę liczb od 1 do 5.
  
 Zazwyczaj będziesz wyświetlać listy wewnątrz [komponentu](/docs/components-and-props.html).
  
-Możemy zmienić poprzedni przykład w komponent który akceptuje tablicę `liczb` i zwraca listę elementów.
+Możemy zmienić poprzedni przykład w komponent który akceptuje tablicę liczb `numbers` i zwraca listę elementów.
  
 ```javascript{3-5,7,13}
 function NumberList(props) {

From 74c4294b61e07c969578420a9df47004f8bf7d07 Mon Sep 17 00:00:00 2001
From: Bartlomiej Zuber <bartlomiej.zuber@outlook.com>
Date: Tue, 2 Apr 2019 20:23:07 +0200
Subject: [PATCH 13/32] translation fix

---
 content/docs/lists-and-keys.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/docs/lists-and-keys.md b/content/docs/lists-and-keys.md
index 2a561ee4b..760705353 100644
--- a/content/docs/lists-and-keys.md
+++ b/content/docs/lists-and-keys.md
@@ -69,7 +69,7 @@ ReactDOM.render(
 );
 ```
  
-Kiedy uruchomisz ten kod, dostaniesz ostrzeżenie o tym że właściwość klucza powinna zostać dostarczona do elementów listy. "Klucz" jest specjalnym atrybutem o typie łańcucha znaków, który musisz dodać podczas tworzenia elementów listy. O tym dlaczego jest to ważne opowiemy w następnej sekcji.
+Kiedy uruchomisz powyższy kod, dostaniesz ostrzeżenie o tym, że do elementów listy należy dostarczyć właściwość klucza. „Klucz” (ang. *key*) jest specjalnym atrybutem o typie łańcucha znaków, który musisz dodać podczas tworzenia elementów listy. O tym, dlaczego jest to ważne, opowiemy w następnej sekcji.
  
 Przypiszmy `klucz` do naszych elementów listy wewnątrz `numbers.map()` czym naprawimy problem z brakującym kluczem.
  

From b2e966dbfb7612c340924c4ec46c627a32fd0a8c Mon Sep 17 00:00:00 2001
From: Jakub Frej <jfrej@users.noreply.github.com>
Date: Tue, 2 Apr 2019 20:26:08 +0200
Subject: [PATCH 14/32] Update content/docs/lists-and-keys.md

Co-Authored-By: bartlomiejzuber <bajtas@gmail.com>
---
 content/docs/lists-and-keys.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/docs/lists-and-keys.md b/content/docs/lists-and-keys.md
index ea1fcf340..dc77205cf 100644
--- a/content/docs/lists-and-keys.md
+++ b/content/docs/lists-and-keys.md
@@ -71,7 +71,7 @@ ReactDOM.render(
  
 Kiedy uruchomisz powyższy kod, dostaniesz ostrzeżenie o tym, że do elementów listy należy dostarczyć właściwość klucza. „Klucz” (ang. *key*) jest specjalnym atrybutem o typie łańcucha znaków, który musisz dodać podczas tworzenia elementów listy. O tym, dlaczego jest to ważne, opowiemy w następnej sekcji.
  
-Przypiszmy `klucz` do naszych elementów listy wewnątrz `numbers.map()` czym naprawimy problem z brakującym kluczem.
+Przypiszmy właściwość `key` do naszych elementów listy wewnątrz `numbers.map()`, czym naprawimy problem brakującego klucza.
  
 ```javascript{4}
 function NumberList(props) {

From 4c322f3e410e4fd839f8bee29e787c0b301e3025 Mon Sep 17 00:00:00 2001
From: Jakub Frej <jfrej@users.noreply.github.com>
Date: Tue, 2 Apr 2019 20:26:32 +0200
Subject: [PATCH 15/32] Update content/docs/lists-and-keys.md

Co-Authored-By: bartlomiejzuber <bajtas@gmail.com>
---
 content/docs/lists-and-keys.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/docs/lists-and-keys.md b/content/docs/lists-and-keys.md
index dc77205cf..87aedb049 100644
--- a/content/docs/lists-and-keys.md
+++ b/content/docs/lists-and-keys.md
@@ -97,7 +97,7 @@ ReactDOM.render(
  
 ## Klucze {#keys}
  
-Klucze pomagają Reaktowi zidentyfikować które elementy uległy zmianie, zostały dodane lub usunięte. Klucze powinny zostać nadane elementom wewnątrz tablic aby zyskały stabilną tożsamość:
+Klucze pomagają Reaktowi zidentyfikować, które elementy uległy zmianie, zostały dodane lub usunięte. Klucze powinny zostać nadane elementom wewnątrz tablicy, aby elementy zyskały stabilną tożsamość:
  
 ```js{3}
 const numbers = [1, 2, 3, 4, 5];

From 8ac5b81d8282661ecfa4d208937c260b2d4ba451 Mon Sep 17 00:00:00 2001
From: Jakub Frej <jfrej@users.noreply.github.com>
Date: Tue, 2 Apr 2019 20:27:00 +0200
Subject: [PATCH 16/32] Update content/docs/lists-and-keys.md

Co-Authored-By: bartlomiejzuber <bajtas@gmail.com>
---
 content/docs/lists-and-keys.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/docs/lists-and-keys.md b/content/docs/lists-and-keys.md
index 87aedb049..42a0c2d6c 100644
--- a/content/docs/lists-and-keys.md
+++ b/content/docs/lists-and-keys.md
@@ -108,7 +108,7 @@ const listItems = numbers.map((number) =>
 );
 ```
  
-Najlepszym sposobem wyboru klucza jest użycie unikatowego ciągu znaków który jednoznacznie identyfikuje element listy spośród jego rodzeństwa. Jako klucze często będziesz używał identyfikatór (*ang.* IDs) ze swoich danych:
+Najlepszym sposobem wyboru klucza jest użycie unikatowego ciągu znaków, który jednoznacznie identyfikuje element listy spośród jego rodzeństwa. Jako kluczy często będziesz używać identyfikatorów (ang. *IDs*) ze swoich danych:
  
 ```js{2}
 const todoItems = todos.map((todo) =>

From 554cf2d2e0a184d3e65933a0b69b12602922993c Mon Sep 17 00:00:00 2001
From: Jakub Frej <jfrej@users.noreply.github.com>
Date: Tue, 2 Apr 2019 20:27:20 +0200
Subject: [PATCH 17/32] Update content/docs/lists-and-keys.md

Co-Authored-By: bartlomiejzuber <bajtas@gmail.com>
---
 content/docs/lists-and-keys.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/docs/lists-and-keys.md b/content/docs/lists-and-keys.md
index 42a0c2d6c..d258f052d 100644
--- a/content/docs/lists-and-keys.md
+++ b/content/docs/lists-and-keys.md
@@ -118,7 +118,7 @@ const todoItems = todos.map((todo) =>
 );
 ```
  
-Kiedy nie będziesz miał stabilnych identyfikatorów dla wyświetlanych elementów, w skrajnym przypadku możesz użyć indeksu jako klucz:
+Kiedy nie będziesz miał stabilnych identyfikatorów dla wyświetlanych elementów, w skrajnym przypadku możesz użyć indeksu jako klucza:
  
 ```js{2,3}
 const todoItems = todos.map((todo, index) =>

From 172a8366781916e65413ebb6d47994579bbeec8d Mon Sep 17 00:00:00 2001
From: Jakub Frej <jfrej@users.noreply.github.com>
Date: Tue, 2 Apr 2019 20:27:44 +0200
Subject: [PATCH 18/32] Update content/docs/lists-and-keys.md

Co-Authored-By: bartlomiejzuber <bajtas@gmail.com>
---
 content/docs/lists-and-keys.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/docs/lists-and-keys.md b/content/docs/lists-and-keys.md
index d258f052d..97b2fb231 100644
--- a/content/docs/lists-and-keys.md
+++ b/content/docs/lists-and-keys.md
@@ -122,7 +122,7 @@ Kiedy nie będziesz miał stabilnych identyfikatorów dla wyświetlanych element
  
 ```js{2,3}
 const todoItems = todos.map((todo, index) =>
-  // Rób to tylko w przypadku gdy elementy nie mają stabilnego identyfikatorów
+  // Rób to tylko w przypadku, gdy elementy nie mają stabilnych identyfikatorów
   <li key={index}>
     {todo.text}
   </li>

From daa60853d37866a1fbddad3126dd779548e001f0 Mon Sep 17 00:00:00 2001
From: Jakub Frej <jfrej@users.noreply.github.com>
Date: Tue, 2 Apr 2019 20:28:20 +0200
Subject: [PATCH 19/32] Update content/docs/lists-and-keys.md

Co-Authored-By: bartlomiejzuber <bajtas@gmail.com>
---
 content/docs/lists-and-keys.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/docs/lists-and-keys.md b/content/docs/lists-and-keys.md
index 97b2fb231..d905828ed 100644
--- a/content/docs/lists-and-keys.md
+++ b/content/docs/lists-and-keys.md
@@ -129,7 +129,7 @@ const todoItems = todos.map((todo, index) =>
 );
 ```
  
-Nie zalecamy używania indeksów jako klucze jeżeli kolejność elementów może ulec zmianie. Może to negatywnie wpłynąć na wydajność i spowodować problemy ze stanem komponentu. Sprawdź artykuł Robin Pokorny na temat [szczegółowego wyjaśnienia negatywnych aspektów używania indeksu jako klucz](https://medium.com/@robinpokorny/index-as-a-key-is-an-anti-pattern-e0349aece318). Jeżeli nie zdecydujesz się jawnie ustawić kluczy dla elementów listy, React domyślnie użyje indeksów jako klucze.
+Nie zalecamy używania indeksów jako kluczy, jeżeli kolejność elementów może ulec zmianie. Może to negatywnie wpłynąć na wydajność i spowodować problemy ze stanem komponentu. Sprawdź artykuł Robina Pokorny'ego ze [szczegółowym wyjaśnieniem negatywnych aspektów używania indeksu jako klucza](https://medium.com/@robinpokorny/index-as-a-key-is-an-anti-pattern-e0349aece318). Jeżeli nie zdecydujesz się jawnie ustawić kluczy dla elementów listy, React domyślnie użyje indeksów jako kluczy.
  
 Jeżeli chciałbyś dowiedzieć się wiecej, to tutaj znajdziesz [szczegółowe wyjaśnienie dlaczego klucze są niezbędne](/docs/reconciliation.html#recursing-on-children).
  

From b464aa5208c41c3cb960bea2f5f5ce98c0b71e8b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20=C5=BBuber?= <bajtas@gmail.com>
Date: Tue, 2 Apr 2019 20:31:49 +0200
Subject: [PATCH 20/32] Apply suggestions from code review

Co-Authored-By: bartlomiejzuber <bajtas@gmail.com>
---
 content/docs/lists-and-keys.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/content/docs/lists-and-keys.md b/content/docs/lists-and-keys.md
index d905828ed..ac92e3b65 100644
--- a/content/docs/lists-and-keys.md
+++ b/content/docs/lists-and-keys.md
@@ -15,7 +15,7 @@ const doubled = numbers.map((number) => number * 2);
 console.log(doubled);
 ```
  
-Ten kod wyświetla w konsoli `[2, 4, 6, 8, 10]`.
+Kod ten wyświetla w konsoli `[2, 4, 6, 8, 10]`.
  
 W Reakcie przekształcanie tablic w listy [elementów](/docs/rendering-elements.html) jest niemalże identyczne.
  
@@ -131,7 +131,7 @@ const todoItems = todos.map((todo, index) =>
  
 Nie zalecamy używania indeksów jako kluczy, jeżeli kolejność elementów może ulec zmianie. Może to negatywnie wpłynąć na wydajność i spowodować problemy ze stanem komponentu. Sprawdź artykuł Robina Pokorny'ego ze [szczegółowym wyjaśnieniem negatywnych aspektów używania indeksu jako klucza](https://medium.com/@robinpokorny/index-as-a-key-is-an-anti-pattern-e0349aece318). Jeżeli nie zdecydujesz się jawnie ustawić kluczy dla elementów listy, React domyślnie użyje indeksów jako kluczy.
  
-Jeżeli chciałbyś dowiedzieć się wiecej, to tutaj znajdziesz [szczegółowe wyjaśnienie dlaczego klucze są niezbędne](/docs/reconciliation.html#recursing-on-children).
+Jeżeli chcesz dowiedzieć się więcej, tutaj znajdziesz [szczegółowe wyjaśnienie, dlaczego klucze są niezbędne](/docs/reconciliation.html#recursing-on-children).
  
 ### Wydrębnianie komponentów z kluczami {#extracting-components-with-keys}
  
@@ -176,7 +176,7 @@ ReactDOM.render(
  
 ```javascript{2,3,9,10}
 function ListItem(props) {
-  // Dobrze! Nie ma potrzeby ustawiania klucza tutaj:
+  // Dobrze! Nie ma potrzeby definiowania klucza tutaj:
   return <li>{props.value}</li>;
 }
  

From 9a99d56af4a1cf9330e0009cc9c0f1f124473bed Mon Sep 17 00:00:00 2001
From: Bartlomiej Zuber <bartlomiej.zuber@outlook.com>
Date: Tue, 2 Apr 2019 20:37:43 +0200
Subject: [PATCH 21/32] translation fixes

---
 content/docs/lists-and-keys.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/docs/lists-and-keys.md b/content/docs/lists-and-keys.md
index ac92e3b65..742c41560 100644
--- a/content/docs/lists-and-keys.md
+++ b/content/docs/lists-and-keys.md
@@ -338,4 +338,4 @@ function NumberList(props) {
  
 [**Przetestuj kod na CodePen**](https://codepen.io/gaearon/pen/BLvYrB?editors=0010)
  
-Czasami dzięki temu kod jest bardziej przejrzysty, jednak ten sposób może być również nadużywany. Tak samo jak w JavaScript, wybór należy do Ciebie czy warto wyodrębnić zmienną aby zwiększyć czytelność. Zapamiętaj że jeżeli in ciało funkcji `map()` jest zbyt zagnieżdżone, to może być dobry czas aby [wyodrębnić komponent](/docs/components-and-props.html#extracting-components).
+Czasami dzięki temu kod staje się bardziej przejrzysty, jednak łatwo doprowadzić do nadużywania tego sposobu. Tak samo jak w JavaScripcie, wybór należy do Ciebie, czy warto wyodrębnić zmienną, aby zwiększyć czytelność. Zapamiętaj, że jeżeli ciało funkcji `map()` jest zbyt zagnieżdżone, może to być odpowiedni moment na [wyodrębnienie komponentu](/docs/components-and-props.html#extracting-components).

From bbc2b6237d0a7b9fef5d87d9b8f1d0ab2014135d Mon Sep 17 00:00:00 2001
From: Bartlomiej Zuber <bartlomiej.zuber@outlook.com>
Date: Tue, 2 Apr 2019 20:52:53 +0200
Subject: [PATCH 22/32] fix translation

---
 content/docs/lists-and-keys.md | 43 +---------------------------------
 1 file changed, 1 insertion(+), 42 deletions(-)

diff --git a/content/docs/lists-and-keys.md b/content/docs/lists-and-keys.md
index 742c41560..4a293eaed 100644
--- a/content/docs/lists-and-keys.md
+++ b/content/docs/lists-and-keys.md
@@ -247,48 +247,7 @@ ReactDOM.render(
  
 [**Przetestuj kod na CodePen**](https://codepen.io/gaearon/pen/NRZYGN?editors=0010)
  
-Klucze służą Reaktowi jako wskazówka, ale nie są one przekazywane do twoich komponentów. Jeżeli potrzebujesz tych wartości w swoim komponencie, przekaż je jawnie poprzez właściwość z inną nazwą:
- 
-```js{3,4}
-const content = posts.map((post) =>
-  <Post
-    key={post.id}
-    id={post.id}
-    title={post.title} />
-);
-```
- 
-W powyższym przykładzie, komponent `Post` może odczytać `props.id`, ale nie `props.key`.
- 
-### Użycie map() wewnątrz JSX {#embedding-map-in-jsx}
- 
-W poprzednich przykładach zadeklarowaliśmy oddzielną zmienną `listItems` wewnątrz JSX:
- 
-```js{3-6}
-function NumberList(props) {
-  const numbers = props.numbers;
-  const listItems = numbers.map((number) =>
-    <ListItem key={number.toString()}
-              value={number} />
-  );
-  return (
-    <ul>
-      {listItems}
-    </ul>
-  );
-}
-```
- 
-JSX pozwala na [wbudowanie każdego wyrażenia](/docs/introducing
-ReactDOM.render(
-  <Blog posts={posts} />,
-  document.getElementById('root')
-);
-```
- 
-[**Przetestuj kod na CodePen**](https://codepen.io/gaearon/pen/NRZYGN?editors=0010)
- 
-Klucze służą Reaktowi jako wskazówka, ale nie są one przekazywane do twoich komponentów. Jeżeli potrzebujesz tych wartości w swoim komponencie, przekaż je jawnie poprzez właściwość z inną nazwą:
+Klucze służą Reactowi jako wskazówka, ale nie są one przekazywane do twoich komponentów. Jeżeli potrzebujesz tych wartości w swoim komponencie, przekaż je jawnie poprzez właściwość o innej nazwie:
  
 ```js{3,4}
 const content = posts.map((post) =>

From d9f591275c4d7153324fa2a11933a29caaf7d4a5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20=C5=BBuber?= <bajtas@gmail.com>
Date: Tue, 2 Apr 2019 20:54:45 +0200
Subject: [PATCH 23/32] Apply suggestions from code review

Co-Authored-By: bartlomiejzuber <bajtas@gmail.com>
---
 content/docs/lists-and-keys.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/content/docs/lists-and-keys.md b/content/docs/lists-and-keys.md
index 4a293eaed..7e106264d 100644
--- a/content/docs/lists-and-keys.md
+++ b/content/docs/lists-and-keys.md
@@ -203,7 +203,7 @@ ReactDOM.render(
  
 [**Przetestuj kod na CodePen**](https://codepen.io/gaearon/pen/ZXeOGM?editors=0010)
  
-Podstawową regułą jest to że elementy wewnątrz wywołania `map()` potrzebują kluczy.
+Podstawową regułą jest to, że elementy wewnątrz wywołania `map()` potrzebują kluczy.
  
 ### Klucze muszą być unikalne tylko spośród rodzeństwa {#keys-must-only-be-unique-among-siblings}
  
@@ -279,7 +279,7 @@ function NumberList(props) {
 }
 ```
  
-JSX pozwala na [wbudowanie każdego wyrażenia](/docs/introducing-jsx.html#embedding-expressions-in-jsx) wewnątrz nawiasów klamrowych, dzięki temu możemy użyć wyniku funkcji `map()` bez przypisywania zmiennej:
+JSX pozwala na [wstawienie dowolnego wyrażenia](/docs/introducing-jsx.html#embedding-expressions-in-jsx) wewnątrz nawiasów klamrowych, dzięki temu możemy użyć wyniku funkcji `map()` bez przypisywania go do zmiennej:
  
 ```js{5-8}
 function NumberList(props) {

From ab1b8d3204eea2a439d2266bd7f6224d6fcc51b4 Mon Sep 17 00:00:00 2001
From: Bartlomiej Zuber <bartlomiej.zuber@outlook.com>
Date: Tue, 2 Apr 2019 20:56:15 +0200
Subject: [PATCH 24/32] translation changes - list and keys

---
 content/docs/lists-and-keys.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/docs/lists-and-keys.md b/content/docs/lists-and-keys.md
index 7e106264d..91428357e 100644
--- a/content/docs/lists-and-keys.md
+++ b/content/docs/lists-and-keys.md
@@ -8,7 +8,7 @@ next: forms.html
  
 Na początku przyjrzymy się, jak przekształca się listy w JavaScripcie.
  
-W kodzie poniżej, użyliśmy funkcji [`map()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map) aby wziąć tablicę `liczb`i podwoić och wartość. Następnie przypisujemy nową tablice zwróconą z funkcji `map()` do zmiennej `doubled` i wyświetlamy ją:
+W kodzie poniżej, użyliśmy funkcji [`map()`](https://developer.mozilla.org/pl/docs/Web/JavaScript/Referencje/Obiekty/Array/map), aby podwoić wartość liczb w tablicy `numbers`. Następnie przypisaliśmy nową tablicę zwróconą z funkcji `map()` do zmiennej `doubled` i wyświetliliśmy ją w konsoli:
 ```javascript{2}
 const numbers = [1, 2, 3, 4, 5];
 const doubled = numbers.map((number) => number * 2);

From c6e78b37db555526ba883da93f2666e534ae6a65 Mon Sep 17 00:00:00 2001
From: Bartlomiej Zuber <bartlomiej.zuber@outlook.com>
Date: Tue, 2 Apr 2019 20:57:46 +0200
Subject: [PATCH 25/32] translation changes - list and keys

---
 content/docs/lists-and-keys.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/docs/lists-and-keys.md b/content/docs/lists-and-keys.md
index 91428357e..eb73314a7 100644
--- a/content/docs/lists-and-keys.md
+++ b/content/docs/lists-and-keys.md
@@ -137,7 +137,7 @@ Jeżeli chcesz dowiedzieć się więcej, tutaj znajdziesz [szczegółowe wyjaśn
  
 Klucze mają sens tylko w kontekście otaczającej tablicy.
  
-Dla przykładu, jeżeli [wyodrębnisz](/docs/components-and-props.html#extracting-components) komponent `ListItem`, powinieneś trzymać klucz na elementach `<ListItem />`wewnątrz tablicy zamiast na elemencie `<li>` wewnątrz elementu `ListItem`.
+Dla przykładu, jeżeli [wyodrębnisz](/docs/components-and-props.html#extracting-components) komponent `ListItem`, trzymaj klucz na elementach `<ListItem />` wewnątrz tablicy zamiast na elemencie `<li>` wewnątrz komponentu `ListItem`.
  
 **Przykłaď: Niepoprawne użycie klucza**
  

From e4c319c76d9183fa1ea8a5c69c9aa7cb2511e6c3 Mon Sep 17 00:00:00 2001
From: Bartlomiej Zuber <bartlomiej.zuber@outlook.com>
Date: Tue, 2 Apr 2019 21:00:08 +0200
Subject: [PATCH 26/32] translation changes - list and keys

---
 content/docs/lists-and-keys.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/content/docs/lists-and-keys.md b/content/docs/lists-and-keys.md
index eb73314a7..3a1cde131 100644
--- a/content/docs/lists-and-keys.md
+++ b/content/docs/lists-and-keys.md
@@ -9,6 +9,7 @@ next: forms.html
 Na początku przyjrzymy się, jak przekształca się listy w JavaScripcie.
  
 W kodzie poniżej, użyliśmy funkcji [`map()`](https://developer.mozilla.org/pl/docs/Web/JavaScript/Referencje/Obiekty/Array/map), aby podwoić wartość liczb w tablicy `numbers`. Następnie przypisaliśmy nową tablicę zwróconą z funkcji `map()` do zmiennej `doubled` i wyświetliliśmy ją w konsoli:
+
 ```javascript{2}
 const numbers = [1, 2, 3, 4, 5];
 const doubled = numbers.map((number) => number * 2);

From 36d666957030be9f247f2e5d772fbcf496507b62 Mon Sep 17 00:00:00 2001
From: Bartlomiej Zuber <bartlomiej.zuber@outlook.com>
Date: Tue, 2 Apr 2019 21:01:42 +0200
Subject: [PATCH 27/32] translation changes - list and keys

---
 content/docs/lists-and-keys.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/docs/lists-and-keys.md b/content/docs/lists-and-keys.md
index 3a1cde131..015e0ca7d 100644
--- a/content/docs/lists-and-keys.md
+++ b/content/docs/lists-and-keys.md
@@ -18,7 +18,7 @@ console.log(doubled);
  
 Kod ten wyświetla w konsoli `[2, 4, 6, 8, 10]`.
  
-W Reakcie przekształcanie tablic w listy [elementów](/docs/rendering-elements.html) jest niemalże identyczne.
+W Reakcie przekształcanie tablic w listy [elementów](/docs/rendering-elements.html) przebiega niemalże identyczne.
  
 ### Wyświetlanie wielu komponentów {#rendering-multiple-components}
  

From 7a911e95fc507c534988de075a8488127e3a6d47 Mon Sep 17 00:00:00 2001
From: Bartlomiej Zuber <bartlomiej.zuber@outlook.com>
Date: Tue, 2 Apr 2019 21:02:47 +0200
Subject: [PATCH 28/32] translation changes - list and keys

---
 content/docs/lists-and-keys.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/docs/lists-and-keys.md b/content/docs/lists-and-keys.md
index 015e0ca7d..c6751f690 100644
--- a/content/docs/lists-and-keys.md
+++ b/content/docs/lists-and-keys.md
@@ -24,7 +24,7 @@ W Reakcie przekształcanie tablic w listy [elementów](/docs/rendering-elements.
  
 Możesz zbudować kolekcje elementów i [dodać je do JSX](/docs/introducing-jsx.html#embedding-expressions-in-jsx) używając nawiasów klamrowych `{}`.
  
-Poniżej iterujemy tablicę liczb `numbers` używając javascriptowej funkcji [`map()`](https://developer.mozilla.org/pl/docs/Web/JavaScript/Referencje/Obiekty/Array/map). Zwracamy element `<li>` dla każdego elementu tablicy. Na koniec przypisujemy wynikową tablicę do `listItems`:
+Poniżej iterujemy tablicę liczb `numbers` używając javascriptowej funkcji [`map()`](https://developer.mozilla.org/pl/docs/Web/JavaScript/Referencje/Obiekty/Array/map). Zwracamy element `<li>` dla każdego elementu tablicy. Na koniec przypisujemy powstałą w ten sposób tablicę do zmiennej `listItems`:
  
 ```javascript{2-4}
 const numbers = [1, 2, 3, 4, 5];

From 024229ac745f26bc439da3494f3929f7656e2ce2 Mon Sep 17 00:00:00 2001
From: Bartlomiej Zuber <bartlomiej.zuber@outlook.com>
Date: Tue, 2 Apr 2019 21:03:18 +0200
Subject: [PATCH 29/32] translation changes - list and keys

---
 content/docs/lists-and-keys.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/docs/lists-and-keys.md b/content/docs/lists-and-keys.md
index c6751f690..c3b236502 100644
--- a/content/docs/lists-and-keys.md
+++ b/content/docs/lists-and-keys.md
@@ -50,7 +50,7 @@ Ten kod wyświetla wypunktowaną listę liczb od 1 do 5.
  
 Zazwyczaj będziesz wyświetlać listy wewnątrz [komponentu](/docs/components-and-props.html).
  
-Możemy zmienić poprzedni przykład w komponent który akceptuje tablicę liczb `numbers` i zwraca listę elementów.
+Możemy przekształcić poprzedni przykład w komponent, który akceptuje tablicę liczb `numbers` i zwraca listę elementów.
  
 ```javascript{3-5,7,13}
 function NumberList(props) {

From 96430fea073b179b06976db96022fd73a0609c14 Mon Sep 17 00:00:00 2001
From: Bartlomiej Zuber <bartlomiej.zuber@outlook.com>
Date: Tue, 2 Apr 2019 21:04:11 +0200
Subject: [PATCH 30/32] translation changes - list and keys

---
 content/docs/lists-and-keys.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/docs/lists-and-keys.md b/content/docs/lists-and-keys.md
index c3b236502..f15c4d8fe 100644
--- a/content/docs/lists-and-keys.md
+++ b/content/docs/lists-and-keys.md
@@ -119,7 +119,7 @@ const todoItems = todos.map((todo) =>
 );
 ```
  
-Kiedy nie będziesz miał stabilnych identyfikatorów dla wyświetlanych elementów, w skrajnym przypadku możesz użyć indeksu jako klucza:
+Jeśli w danych nie masz stabilnych identyfikatorów dla wyświetlanych elementów, w skrajnym przypadku do określenia klucza możesz użyć indeksu elementu tablicy:
  
 ```js{2,3}
 const todoItems = todos.map((todo, index) =>

From 6229aaf26588f63b5ea27eb2724be441052df2ff Mon Sep 17 00:00:00 2001
From: Jakub Frej <jfrej@users.noreply.github.com>
Date: Sat, 6 Apr 2019 18:40:35 +0200
Subject: [PATCH 31/32] Apply suggestions from code review

Co-Authored-By: bartlomiejzuber <bajtas@gmail.com>
---
 content/docs/lists-and-keys.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/docs/lists-and-keys.md b/content/docs/lists-and-keys.md
index f15c4d8fe..c2da0125f 100644
--- a/content/docs/lists-and-keys.md
+++ b/content/docs/lists-and-keys.md
@@ -134,7 +134,7 @@ Nie zalecamy używania indeksów jako kluczy, jeżeli kolejność elementów mo
  
 Jeżeli chcesz dowiedzieć się więcej, tutaj znajdziesz [szczegółowe wyjaśnienie, dlaczego klucze są niezbędne](/docs/reconciliation.html#recursing-on-children).
  
-### Wydrębnianie komponentów z kluczami {#extracting-components-with-keys}
+### Wyodrębnianie komponentów z kluczami {#extracting-components-with-keys}
  
 Klucze mają sens tylko w kontekście otaczającej tablicy.
  

From 918df694dc3882ee07108132eb615710bbc10ed6 Mon Sep 17 00:00:00 2001
From: Jakub Frej <jfrej@users.noreply.github.com>
Date: Sat, 6 Apr 2019 18:43:37 +0200
Subject: [PATCH 32/32] Update content/docs/lists-and-keys.md

Co-Authored-By: bartlomiejzuber <bajtas@gmail.com>
---
 content/docs/lists-and-keys.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/docs/lists-and-keys.md b/content/docs/lists-and-keys.md
index c2da0125f..91ba46d86 100644
--- a/content/docs/lists-and-keys.md
+++ b/content/docs/lists-and-keys.md
@@ -206,7 +206,7 @@ ReactDOM.render(
  
 Podstawową regułą jest to, że elementy wewnątrz wywołania `map()` potrzebują kluczy.
  
-### Klucze muszą być unikalne tylko spośród rodzeństwa {#keys-must-only-be-unique-among-siblings}
+### Klucze muszą być unikalne tylko wśród rodzeństwa {#keys-must-only-be-unique-among-siblings}
  
 Klucze używane wewnątrz tablic powinny być unikalne w kontekście swojego rodzeństwa. Jednakże nie muszą one być niepowtarzalne globalnie. Możemy użyć tych samych kluczy, gdy tworzymy dwie różne tablice: