Refine the intro to Python

Author: encukou

lessons/fast-track/bool/index.md

@@ -21,19 +21,22 @@ Funguje to i se složitějšími výrazy:
 True
 ```
 
-„Větší než“ a „menší než“ používají značky známé z matematiky.
-Chceš-li se ale zeptat, jestli jsou dvě čísla stejná, je to trochu jiné:
+„Větší než“ a „menší než“ jsou značky známé z matematiky.
+Chceš-li se ale zeptat, jestli jsou dvě čísla stejná, je potřba použít
+trochu jiný zápis:
 
 ``` pycon
 >>> 1 == 1
 True
 ```
 
-Jedno rovnítko `=` používáme pro přiřazení hodnoty do proměnné.
-Když chceš zkontrolovat, jestli se věci navzájem rovnají, vždy, **vždy** musíš dát dvě rovnítka `==`.
+Jedno rovnítko `=` používáme pro *přiřazení* hodnoty do proměnné.
+Když chceš zkontrolovat, jestli se věci navzájem *rovnají*, vždy, **vždy**
+musíš dát dvě rovnítka `==`.
 
-Další možnosti porovnávání jsou nerovnost (≠), větší než (≤) a meší než (≥).
-Většina lidí tyhle symboly nemá na klávesnici, a tak se používá `!=`, `<=`
+Další možnosti porovnávání jsou nerovnost (≠), větší nebo rovno (≤)
+a meší nebo rovno (≥).
+Většina lidí tyhle symboly nemá na klávesnici, a tak Python používá `!=`, `<=`
 a `>=`.
 
 ``` pycon
@@ -45,9 +48,35 @@ False
 True
 ```
 
+Už jsi někdy slyšel{{a}} výraz „srovnávat jablka a hrušky“? Zkusme v Pythonu ekvivalent:
+
+``` pycon
+>>> 1 > 'krajta'
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+TypeError: '>' not supported between instances of 'int' and 'str'
+```
+
+Stejně jako nelze srovnávat „jablka a hrušky“,
+Python není schopen porovnávat řetězce (`str`) a čísla (`int`).
+Místo toho zobrazí `TypeError` a říká nám, že tyto dva typy nelze porovnat.
+
+Co se stane, když v minulé ukázce zaměníš `>` za `==`?
+
+{% filter solution %}
+```pycon
+>>> 1 == 'krajta'
+False
+```
+
+Jablka a hrušky nemůžeš porovnávat, ale můžeš si potvrdit že jsou to dvě různé
+věci.
+{% endfilter %}
+
+
 ## Logika
 
-Chceš zkusit ještě něco? Zkus tohle:
+Chceš zkusit ještě něco? Zadej tohle:
 
 ``` pycon
 >>> 6 > 2 and 2 < 3
@@ -63,32 +92,20 @@ V Pythonu můžeš zkombinovat několik porovnání do jednoho!
 *   Pokud použiješ operátor `and`, obě strany musí být pravdivé, aby byl celý výraz pravdivý.
 *   Pokud použiješ operátor `or`, stačí aby jen jedna strana z porovnání byla pravdivá.
 
-Už jsi někdy slyšel{{a}} výraz „srovnávat jablka a hrušky“? Zkusme v Pythonu ekvivalent:
-
-``` pycon
->>> 1 > 'krajta'
-Traceback (most recent call last):
-  File "<stdin>", line 1, in <module>
-TypeError: '>' not supported between instances of 'int' and 'str'
-```
-
-Stejně jako nelze srovnávat „jablka a hrušky“,
-Python není schopen porovnávat řetězce (`str`) a čísla (`int`).
-Místo toho zobrazí `TypeError` a říká nám, že tyto dva typy nelze porovnat.
-
 
 ## Pravdivostní hodnoty
 
 Mimochodem, právě ses dozvěděl{{a}} o novém typu objektu v Pythonu.
-Říká se mu *pravdivostní hodnota*, nebo častěji anglicky *boolean*.
+Podobně jako máme řetězec, číslo, seznam nebo slovník existuje
+*pravdivostní hodnota*, nebo častěji anglicky *boolean*.
 
 Může mít jednu z dvou hodnot: `True` a `False`.
 
 Aby Python pochopil, že se jedná o tento typ,
 je potřeba dávat pozor na velikost písmen.
 `true`, `TRUE`, `tRUE` nebude fungovat – jedině `True` je správně.
 
-Jako každou hodnotu, i pravdivostní hodnotu můžeš uložit do proměnné:
+Jako každou hodnotu, i *boolean* můžeš uložit do proměnné:
 
 ``` pycon
 >>> a = True
@@ -103,3 +120,13 @@ Stejně tak můžeš uložit i výsledek porovnání:
 >>> a
 False
 ```
+
+
+## Shrnutí
+
+V této sekci ses dozvěděl{{a}}:
+
+*   V Pythonu můžeš **porovnávat** pomocí operátorů `>`, `>=`, `==` `<=`, `<`, `!=`
+*   Operátory `and` a `or` umí **zkombinovat** dvě porovnání.
+*   **Boolean** (pravdivostní hodnota) je typ, který může mít jednu ze dvou
+    hodnot: `True` (pravda) nebo `False` (nepravda).

lessons/fast-track/def/index.md

@@ -13,8 +13,8 @@ Třeba funkce, která tě pozdraví, by měla:
 * Vypsat „jak se máš?“
 
 Definice funkce v Pythonu začíná klíčovým slovem `def`,
-dále je uveden název a závorky (zatím prázdné).
-Pak jako po `if` dvojtečka, a odsazené příkazy,
+dále je uveden název a následují závorky (zatím prázdné).
+Pak je jako po `if` dvojtečka – a odsazené příkazy,
 které má funkce provést.
 
 ```python
@@ -73,16 +73,18 @@ NameError: name 'pozdrav' is not defined
 Python si stěžuje na `NameError` – nezná nic jménem `pozdrav`.
 
 Python totiž program čte odzhora dolů.
-Až příkazem `def` se „naučí" jak zdravit –
+Až příkazem `def` se „naučí" jak zdravit.
 Předtím, než se k příkazu `def` dostane, funkce neexistuje.
 {% endfilter %}
 
 ## Parametry
 
+Tvoje funkce se dá volat jen jako `pozdrav()`.
 Funkce jako `len('slovo')` a `print(1 + 2)` umí navíc pracovat s hodnotou.
 
-Pojďme napisať funkciu, ktorá ťa pozdraví menom.
+Poďme napisať funkciu, ktorá ťa pozdraví menom.
 (Uľahčíme si to použitím jazyka, ktorý nepoužíva piaty pád.)
+{# XXX: Je to správně slovensky? #}
 
 ```python
 def pozdrav(meno):
@@ -138,3 +140,11 @@ pozdrav('Ola')
 pozdrav('Soňa')
 ```
 
+
+## Shrnutí
+
+Co bylo nového tentokrát?
+
+* **Funkce** umožňuje pojmenovat nějkolik příkazů, a pak je zavolat najednou.
+* **Parametry** funkce, hodnoty se kterými funkce pracuje,
+  se zadávají v závorkách.

lessons/fast-track/dict/index.md

@@ -25,19 +25,18 @@ Klíč a hodnota jsou oddělené dvojtečkou,
 jednotlivé dvojice se od sebe oddělují čárkou,
 a celý slovník je uzavřený ve složených závorkách.
 
-Když budeš chtít v takovém slovníku něco najít, potřebuješ vědět, co hledat.
-Konkrétně *klíč*.
-Pomocí hranatých závorek můžeš zjistit hodnotu, která odpovídá danému klíči:
+Když budeš chtít v takovém slovníku něco najít, potřebuješ vědět co hledat.
+Potřebuješ *klíč*.
+Pomocí hranatých závorek můžeš zjistit hodnotu, která danému klíči odpovídá:
 
 
 ``` pycon
 >>> slovnik['Jablko']
 'Apple'
 ```
 
-Je to podobné jako u seznamů, jen v hranatých závorkách není pořadí prvku,
-ale klíč.
-{# XXX: Slicing taky nejde #}
+Je to podobné jako u seznamů, jen v hranatých závorkách není index
+(pořadí prvku) nebo rozmezí s dvojtečkou, ale klíč.
 
 > [note]
 > Naopak to nejde – slovník neumožňuje podle hodnoty přímo zjistit klíč.
@@ -135,11 +134,10 @@ Verča se přestěhovala do zahraničí a má nové číslo: `+897 3788509`.
 
 ## Shrnutí
 
-Skvělé! Nyní víš o programování hodně. V této poslední části jsi poznal{{a}}:
+Skvělé! Co víš o slovnících:
 
-*   **chyby** - hlášky které Python zobrazí když nerozumí příkazu který jsi zadal{{a}} nebo ho neumí splnit
-*   **proměnné** - názvy pro objekty, které umožňují psát čitelnější kód
-*   **seznam** - sekvence objektů uložených v určitém pořadí
-*   **slovník** - sbírka záznamů klíč–hodnota
+* **Záznam** se skládá z **klíče** a **hodnoty**.
+* Ve slovníku se hledá pomocí **klíče**.
+* Záznamy se dají přepsat, přidat, nebo pomocí `del` smazat.
 
 Jsi připraven{{a}} na další část?

lessons/fast-track/for/index.md

@@ -4,7 +4,7 @@ Programátoři se neradi opakují.
 Programování je o automatizaci: nebudeme zdravit každého člověka zvlášť,
 vezměme seznam padesáti lidí a pozdravíme je všechny najednou!
 
-(Hm, někteří programátoři nejsou moc sociálně nadaní.
+(No, někteří programátoři asi nejsou moc sociálně nadaní.
 Ale jinde se ta automatizace fakt hodí!)
 
 Ještě si vzpomínáš na seznamy?
@@ -63,14 +63,15 @@ Když chceš něco 200-krát zopakovat, napiš:
 
 ```python
 for i in range(200):
-     print("Nebudu házet igelit do táboráku!")
+     print("Nebudu nikdy házet igelit do táboráku!")
 ```
 
 Jak to funguje?
 `for i in range(X)` se dá přeložit jako „pro každé číslo
 od nuly do <var>X</var>“.
-Do proměnné `i` Python uloží, pokolikáté cyklem prochází – počínaje,
-v programátorském stylu, od nuly:
+Funkce `range` onu posloupnost čísel od nuly do <var>X</var> vytvoří.
+Do proměnné `i` Python postupně uloží každé číslo, podle toho po kolikáté
+cyklem prochází.
 
 ```python
 for i in range(5):
@@ -84,25 +85,24 @@ for i in range(5):
 4
 ```
 
-`range` je funkce, která vytvoří seznam s posloupností čísel (tato čísla zadáváš jako parametry funkce).
+Všimni si, že samotné `5` není zahrnuto ve výsledku:
+`range(5)` počítá od 0 do 4.
+Když počítáš od nuly a chceš pět čísel, skončíš u čtyřky.
 
-Všimni si, že druhé z těchto dvou čísel není zahrnuto v seznamu, který je výstupem Pythonu (`range (1, 6)` počítá od 1 do 5, ale nezahrnuje číslo 6). To je proto, že "range" je z poloviny otevřený, čímž myslíme, že obsahuje první hodnotu, ale ne poslední.
 
 ## Shrnutí
 
 A je to.
 *Jsi naprosto skvěl{{gnd('ý', 'á')}}!*
-Tohle byla složitá kapitola, takže bys na sebe měl{{a}} být hrd{{gnd('ý', 'á')}}.
+Tohle byla složitá lekce, takže bys na sebe měl{{a}} být hrd{{gnd('ý', 'á')}}.
 My jsme na tebe velmi hrdí za to, že ses dostal{{a}} tak daleko!
 
 Naučil{{a}} ses:
 
-*   **Definice funkcí** – jak pojmenovat pár příkazů
-*   **Cykly** – jak opakovat nějaký postup několikrát po sobě
+*   **Cyklus** je způsob, jak opakovat nějaký postup několikrát po sobě
+*   `range` pomáhá když potřebuješ určitý konkrétní počet opakování.
 
 Můžeš si jít krátce odpočinout – protáhnout se, projít se,
 zavřít oči – než se pustíme do další kapitoly. :)
 
 🧁
-
- {# XXX: range #}

lessons/fast-track/if/index.md

@@ -58,7 +58,7 @@ Ještě lepší program by ale:
 * Zeptá se na tajné heslo
 * Když je heslo správné:
     * Pustí uživatele dovnitř
-* Jinak:
+* Jinak <small>(tedy pokud heslo nebylo správné)</small>:
     * Spustí alarm
 
 K tomu má Python příkaz `else` – „jinak“:
@@ -126,11 +126,9 @@ příslušnou hlášku a další možnosti přeskočí.
 
 ## Shrnutí
 
-V posledních třech cvičeních ses dozvěděl{{a}} o:
-
-*   **Porovnání věcí** - v Pythonu můžeš porovnávat věci pomocí operátorů `>`, `>=`, `==` `<=`, `<`, `!=` a `and`, `or`
-*   **Pravdivostní hodnoty / Boolean** - typ, který může mít pouze jednu ze dvou hodnot: `True` nebo `False`
-*   **Ukládání do souborů** - pokud uložíš kód do souboru, můžeš spouštět větší programy
-*   **if – elif – else** - příkazy, které umožňují spouštět kód pouze v případě, kdy jsou splněny určité podmínky.
+Co jsi viděl{{a}} v této lekci?
 
-Čas na předposlední část této kapitoly!
+*   Příkazy **if** (pokud), **elif** (jinak, pokud) a **else** (jinak)
+    podmiňují jiné příkazy.
+*   **Odsazení** se používá pro podmíněné příkazy, které následují po
+    `if` apod..