English	Polish	Comment
ahead-of-time compilation	kompilacja z wyprzedzeniem
API reference	dokumentacja API
array	tablica
arrow function	funkcja strzałkowa	za pierwszym razem dopisek (ang. *arrow function*)
assertion; to assert	asercja lub sprawdzenie; wykonać sprawdzenie lub sprawdzać, testować
asset	zasób
boilerplate	kod szablonowy	za pierwszym razem (ang. *boilerplate*)
breaking older browsers	nie jest kompatybilny ze starszymi przeglądarkami
bug	błąd
build pipeline	potok budowania
bundler	bundler
callback	funkcja zwrotna	za pierwszym razem dopisem (ang. *callback*)
camelCase	notacja "camelCase"	odmiana: camelCasem, ale: camelCase'owi, camelCase'a lub z dodatkiem słowa "notacja" - wtedy odmieniamy tylko to słowo
CDN	CDN
child component	komponent potomny
client(s)	klient(y)	NIE: klienci
commit	(na Gicie) commit, commitem, (poza Gitem) czas. akceptować, wdrażać, potwierdzać
component wrapping	opakowywanie komponentu
concept, idea	koncepcja, zagadnienie
controlled component	komponent kontrolowany
data	wartość, dane
debugging	debugowanie
destructuring assignment	przypisanie destrukturyzujące
Dev Tools	Narzędzia deweloperskie
development server	serwer deweloperski
dispatcher	dyspozytor	za pierwszym razem dopisem (ang. *dispatcher*)
dispatching an event	przesyłanie zdarzenia
dummy component	sztuczny komponent
element	element
event handler	procedura obsługi zdarzenia
fallback	zastępczy lub awaryjny
focus	fokus	"ustawianie fokusu na polu formularza" lub "aktywowanie pola formularza"
framework	framework
generic	generyczny, ogólny, ogólnego użytku
Git, GitHub	Git, Gitem, Gicie; GitHub, GitHubem, GitHubie
Glossary	Słownik pojęć
hands-on tutorial	praktyczny tutorial
HTML entities	encje HTML
immutable	niezmienny	za pierwszym razem dopisek (ang. *immutable*)
inline condition	warunek wewnątrzliniowy
input (data)	dane wejściowe
JavaScript	M:JavaScript, D:JavaScriptu, C:JavaScriptowi, B:JavaScriptu, N:JavaScriptem, Ms:JavaScripcie, W:JavaScript	przymiotnik piszemy małymi literami: "javascriptowy"
lazy initialization	leniwa inicjalizacja	za pierwszym razem (ang. *lazy initialization*)
library	biblioteka
lowercase	małymi literami	NIE piszemy: "z małej litery"!
local storage	pamięć lokalna
minify, minification	czas. minifikować, rzecz. minifikacja
mocked component, component mock	atrapa komponentu
opt-in	(stosowane) wedle własnego uznania
output (data)	dane wyjściowe, rezultat, wynik
overview	ogólne informacje
playground	środowisko eksperymentalne
polyfill	łatka
primitive	typ podstawowy
Promise	obietnica	za pierwszym razem (ang. *promise*)
property	właściwość	zmienna w obiekcie
read-only	tylko do odczytu
render	czas. renderować, rzecz. renderowanie	alternatywa: "wyświetlać"
(HTTP) request	rzecz. żądanie (HTTP), czas. wysyłać żądanie
(HTTP) response	rzecz. odpowiedź (HTTP)
reusable	wielokrotnego użytku
sandbox	środowisko izolowane
roadmap	plan działania
section	podrozdział, rozdział, sekcja
shallow rendering	renderowanie płytkie
Single Page Application, SPA	aplikacja jednostronicowa
snapshot	zrzut
spread operator	operator rozszczepienia
state	stan
store	magazyn
string	"ciąg znaków" lub "łańcuch znaków" lub "napis" lub "literał znakowy"
syntactic sugar	lukier składniowy	za pierwszym razem (ang. *syntactic sugar*)
tag [HTML]	znacznik [HTML]
template literal	literał szablonowy	za pierwszym razem (ang. *template literal*)
term	pojęcie
throws an exception	rzuca wyjątek
two-way binding	wiązanie dwukierunkowe	alternatywnie "one-way binding" jako "jednokierunkowe"
UI	"UI" lub "interfejs użytkownika"
uncontrolled component	komponent niekontrolowanie
update	czas. aktualizuje, rzecz. aktualizacja
uppercase	wielkimi literami	NIE piszemy: "z wielkiej litery"!
Versioned Documentation	Dokumentacja wersji
wrapper component	komponent opakowujący

Zasady tłumaczenia

Tytuły rozdziałów

Tytuły (np. rozdziałów, książek, utworów) piszemy w cudzysłowie bądź też bez cudzysłowu, ale kursywą (patrz: poradnia PWN)

Przykłady:

• ... znajdziesz w rozdziale pt. "Jak łączyć się z API"?
• ... znajdziesz w rozdziale pt. Jak łączyć się z API?

Odmiana nazw własnych

• Nazwy własne odmieniamy zgodnie z obowiązującymi zasadami w języku polskim (przydatna okazuje się tu wyszukiwarka Poradni PWN). Przykłady: Link 1, Link 2, Link 3.

Zwroty do czytelnika

• Nie piszemy "Ci", "Tobie", "Twój", lecz "ci", "tobie", "twój".
• Staramy się, żeby tekst był spójny i logiczny, nawet jeśli taki nie jest w oryginale.
• Ten samouczek jest dość nieformalny i ma być przyjazny dla czytelnika, dlatego możemy spokojnie pisać "mamy", "robimy" itp.
• Nie piszmy "zrobiłeś", "przeczytałeś" (ze wskazaniem na rodzaj męski), bo to jest kiepsko odbierane (nawet nie chodzi o równouprawnienie i tym podobne, a o sam "dysonans" podczas czytania przez kobiety ;)).

Tłumaczenie kodu

Co można tłumaczyć:

• komentarze
• stringi, jeśli są tylko tekstem wyświetlanym na stronie

Czego nie można tłumaczyć:

• nazw zmiennych, funkcji, klas
• słów kluczowych
• stringów, które są interpretowane przez kod (np. klasy w CSS)