diff --git a/docs/i18n-languages/polish/CONTRIBUTING.md b/docs/i18n-languages/polish/CONTRIBUTING.md new file mode 100644 index 0000000000..f4cf2bc6f4 --- /dev/null +++ b/docs/i18n-languages/polish/CONTRIBUTING.md @@ -0,0 +1,117 @@ +# Wytyczne dotycz膮ce twojego wk艂adu w FreeCodeCamp + +Cze艣膰. 馃憢 + +Funkcjonowanie freeCodeCamp.org jest mo偶liwe dzi臋ki tysi膮com 偶yczliwych wolontariuszy takich jak Ty. Jeste艣my wdzi臋czni za Tw贸j wk艂ad i cieszymy si臋, 偶e mo偶emy powita膰 Ci臋 na pok艂adzie. + +艢ci艣le egzekwujemy nasz [鈥濳odeks post臋powania鈥漖(https://www.freecodecamp.org/code-of-conduct). Po艣wi臋膰 chwil臋, aby go przeczyta膰. Ma tylko 196 s艂贸w. + +Szcz臋艣liwego rozwijania kodu open source! + +## Oto kilka fajnych sposob贸w, w kt贸re mo偶esz pom贸c + +Mo偶esz przyczyni膰 si臋 do jednego z tych rzeczy: + + +1. [Rozwijaj t臋 otwarto藕r贸d艂ow膮 baz臋 danych](#https://github.com/freeCodeCamp/freeCodeCamp/). Pom贸偶 nam edytowa膰 wyzwania zwi膮zane z kodowaniem lub naprawiaj b艂臋dy na platformie edukacyjnej. + +2. Pomoc dla kamper贸w na naszym [forum publicznym](https://www.freecodecamp.org/forum/). [Odpowiedz na聽pytania dotycz膮ce kodowania](https://www.freecodecamp.org/forum/?max_posts=1) lub聽[podaj im informacje zwrotne na聽temat ich projekt贸w kodowania](https://www.freecodecamp.org/forum/c/project-feedback?max_posts=1). + +3. Pom贸偶 nam dodawa膰 napisy (podpisy zamkni臋te) do naszych [Film贸w na kanale YouTube](https://www.youtube.com/channel/UC8butISFwT-Wl7EV0hUK0BQ/videos). + +## Przyczyniaj si臋 do tej otwartej 藕r贸d艂owej bazy danych. + +Nasza baza danych zawiera tysi膮ce [wyzwa艅 zwi膮zanych z kodowaniem](https://learn.freecodecamp.org) oraz inne kody 藕r贸d艂owe, kt贸re zasilaj膮 nasz膮 platform臋 edukacyjn膮. + +##### Tw贸rz, aktualizuj i naprawiaj b艂臋dy w naszych wyzwaniach zwi膮zanych z kodowaniem. + +Wszystkie nasze wyzwania zwi膮zane z kodowaniem s膮 obs艂ugiwane przez spo艂eczno艣膰, dostarczaj膮c膮 specjalistyczn膮 wiedz臋 od wolontariuszy takich jak Ty. + +Mo偶esz pom贸c je rozszerzy膰 i poprawi膰 ich brzmienie. Mo偶esz r贸wnie偶 aktualizowa膰 historie u偶ytkownik贸w, aby lepiej wyja艣ni膰 koncepcj臋 lub usun膮膰 zb臋dne i poprawi膰 testy wyzwa艅, aby lepiej testowa艂y kod ludzi. + +**Je艣li jeste艣 zainteresowany popraw膮 tych wyzwa艅 zwi膮zanych z kodowaniem, oto [jak pracowa膰 nad wyzwaniami zwi膮zanymi z kodowaniem](/docs/how-to-work-on-coding-challenges.md).** + +##### Pom贸偶 nam naprawi膰 b艂臋dy w platformie edukacyjnej freeCodeCamp.org + +Nasza platforma edukacyjna dzia艂a na nowoczesnym stosie JavaScript. Posiada r贸偶ne komponenty, narz臋dzia i biblioteki, w tym mi臋dzy innymi Node.js, MongoDB, LoopBack, OAuth 2.0, React, Gatsby, Webpack i wiele innych. + +Og贸lnie rzecz bior膮c, + +- Mamy serwer API oparty na Node.js. +- Zestaw aplikacji klienckich opartych na React. +- Skrypt, kt贸rego u偶ywamy do oceny naszych projekt贸w front-end. +rozwijanie naszego stacku wymaga troch臋 zrozumienia API, ES6 Syntax, i ch臋ci nauki. + +Zasadniczo oczekujemy podstawowej znajomo艣ci niekt贸rych z wy偶ej wymienionych technologii, narz臋dzi i bibliotek. Bior膮c to pod uwag臋, nie jeste艣cie zobowi膮zani do bycia ekspertem w tym zakresie, aby m贸c wnie艣膰 sw贸j wk艂ad. + +**Je艣li chcesz pom贸c nam udoskonali膰 nasz膮 baz臋 danych, mo偶esz albo [skonfigurowa膰 freeCodeCamp lokalnie](/docs/how-to-setup-freecamp-locally.md) albo u偶y膰 Gitpod, darmowego 艣rodowiska online dev.** + +[![Otw贸rz w Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://github.com/freeCodeCamp/freeCodeCamp) + +(Uruchamia gotowe do kodowania 艣rodowisko dev dla freecodecamp w przegl膮darce.) + +## Najcz臋艣ciej zadawane pytania + +### Jak mog臋 zg艂osi膰 b艂膮d, kt贸rego nie ma na pok艂adzie? + +Je艣li uwa偶asz, 偶e znalaz艂e艣 b艂膮d, przeczytaj najpierw artyku艂 ["Help I've Found a Bug"](https://forum.freecodecamp.org/t/how-to-report-a-bug/19543) i post臋puj zgodnie z jego instrukcjami. + +Je艣li jeste艣 pewien, 偶e jest to nowy b艂膮d, stw贸rz nowy problem z GitHub. Upewnij si臋, 偶e do艂膮czysz jak najwi臋cej informacji, aby艣my mogli odtworzy膰 b艂膮d. Mamy predefiniowany szablon problemu, kt贸ry pomo偶e Ci w jego rozwi膮zaniu. + +Prosz臋 zwr贸ci膰 uwag臋, 偶e wszelkie problemy, kt贸re szukaj膮 pomocy przy kodowaniu w przypadku wyzwania, zostan膮 zamkni臋te. 艢ledzenie spraw jest 艣ci艣le zwi膮zane z zagadnieniami zwi膮zanymi z baz膮 danych i dyskusjami. W razie w膮tpliwo艣ci, przed sporz膮dzeniem raportu nale偶y [szuka膰 pomocy na forum](https://www.freecodecamp.org/forum). + +##### Jak mog臋 zg艂osi膰 problem bezpiecze艅stwa? + +Prosz臋 nie tworzy膰 problem贸w z GitHub w sprawach bezpiecze艅stwa. Zamiast tego, wy艣lij e-mail na adres `security@freecodecamp.org` i natychmiast si臋 temu przyjrzymy. + +##### Co oznaczaj膮 te r贸偶ne etykiety, kt贸re s膮 oznaczone na tematach? + +Nasi moderatorzy spo艂eczno艣ci [triage](https://en.wikipedia.org/wiki/Software_bug#Bug_management) zg艂aszaj膮 problemy i wnioski w oparciu o ich priorytet, dotkliwo艣膰 i inne czynniki. Mo偶esz [znale藕膰 kompletny s艂owniczek ich znacze艅 tutaj](https://github.com/freecodecamp/freecodecamp/labels). + +Powiniene艣 przej艣膰 przez [**`help wanted`**](https://github.com/freeCodeCamp/freeCodeCamp/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22) lub [**`first timers welcome`**](https://github.com/freeCodeCamp/freeCodeCamp/issues?q=is%3Aopen+is%3Aissue+label%3A%22first+timers+welcome%22) w celu szybkiego przegl膮du tego, nad czym mo偶esz pracowa膰. + +S膮 one do pobrania i nie musisz ubiega膰 si臋 o pozwolenie przed rozpocz臋ciem pracy nad nimi. Je艣li te kwestie nie s膮 jasne, co nale偶y zrobi膰, nie kr臋puj si臋 zadawa膰 pyta艅 w komentarzach. + +#### Znalaz艂em liter贸wk臋, czy powinienem zg艂osi膰 problem, zanim z艂o偶臋 pro艣b臋 o ci膮gni臋cie? + +W przypadku liter贸wek i innych zmian w s艂ownictwie, mo偶esz bezpo艣rednio otwiera膰 偶膮dania ci膮gni臋cia bez wcze艣niejszego tworzenia problemu. Problemy s膮 bardziej przydatne do om贸wienia wi臋kszych problem贸w zwi膮zanych z kodem lub aspektami strukturalnymi programu nauczania. + +##### Jak mog臋 dosta膰 problem przypisany do mnie? + +Zazwyczaj nie przydziela si臋 problem贸w nikomu innemu ni偶 d艂ugoletnim wsp贸艂pracownikom, aby unikn膮膰 ambitnego nie dostarczenia wynik贸w. Zamiast tego post臋pujemy zgodnie z poni偶sz膮 polityk膮, aby by膰 sprawiedliwym dla wszystkich: + +1. Preferowane jest po艂膮czenie pierwszego wniosku o wyci膮gni臋cie r臋ki w ka偶dej sprawie. +2. W przypadku wielokrotnych pr贸艣b o ten sam problem, dajemy pierwsze艅stwo jako艣ci kodu w pr贸艣b o wyci膮gni臋cie. + - Czy do艂膮czy艂e艣 testy? + - Czy z艂apa艂e艣 wszystkie przypadki? + - Czy upewni艂e艣 si臋, 偶e wszystkie testy przesz艂y pomy艣lnie i potwierdzi艂e艣, 偶e wszystko dzia艂a lokalnie? +3. W ko艅cu popieramy pro艣by o poci膮gni臋cie, kt贸re s膮 zgodne z naszymi zaleceniami. + - Pod膮偶a艂 pan za list膮 kontroln膮? + - Czy poda艂e艣 nazw臋 swojej listy kontrolnej w spos贸b znacz膮cy? + +Nie potrzebujesz 偶adnego zezwolenia dla spraw, kt贸re s膮 oznaczone jako "potrzebna pomoc" lub "nowicjusze mile widziani", jak wyja艣niono wcze艣niej. Post臋puj zgodnie z wytycznymi i otw贸rz pro艣b臋 o pomoc. + +##### Jestem nowy w GitHubie i Open Source, od czego powinienem zacz膮膰? + +Przeczytaj nasz [Poradnik jak wnie艣膰 wk艂ad do Open Source](https://github.com/freeCodeCamp/how-to-contribute-to-open-source). + +##### Utkn膮艂em na czym艣, co nie jest zawarte w tej dokumentacji. Jak mog臋 uzyska膰 pomoc? + +Mo偶esz poprosi膰 o pomoc: + +- [Kategoria "Wsp贸艂tw贸rcy" na naszym forum publicznym](https://www.freecodecamp.org/forum/c/contributors) +- [Nasz publiczny chat room dla wsp贸艂pracownik贸w na Gitterze](https://gitter.im/FreeCodeCamp/Contributors) + +Jeste艣my podekscytowani, by pom贸c Ci we wzi臋ciu udzia艂u we wszystkich tematach, nad kt贸rymi chcia艂by艣 pracowa膰. Zach臋camy do zadawania nam pyta艅 na tematy pokrewne, a my ch臋tnie udzielimy wyja艣nie艅. Upewnij si臋, 偶e szukasz swojego zapytania przed wys艂aniem nowego. B膮d藕 uprzejmy i cierpliwy. Nasza spo艂eczno艣膰 wolontariuszy i moderator贸w jest zawsze w pobli偶u, aby poprowadzi膰 Ci臋 przez Twoje pytania. + +Je艣li masz w膮tpliwo艣ci, mo偶esz skontaktowa膰 si臋 z naszym zespo艂em programist贸w platformy, aby Ci w tym pom贸c: + + +| kontakt | GitHub | Twitter | +|:----------------|:-------|:--------| +| Mrugesh Mohapatra | [`@raisedadead`](https://github.com/raisedadead) | [`@raisedadead`](https://twitter.com/raisedadead)| +| Ahmad Abdolsaheb | [`@ahmadabdolsaheb`](https://github.com/ahmadabdolsaheb) | [`@Abdolsaheb`](https://twitter.com/Abdolsaheb) | +| Kristofer Koishigawa | [`@scissorsneedfoodtoo`](https://github.com/scissorsneedfoodtoo) | [`@kriskoishigawa`](https://twitter.com/kriskoishigawa) | + +> **Email: `dev@freecodecamp.org`** + diff --git a/docs/i18n-languages/polish/devops.md b/docs/i18n-languages/polish/devops.md new file mode 100644 index 0000000000..8d2451e1f6 --- /dev/null +++ b/docs/i18n-languages/polish/devops.md @@ -0,0 +1,27 @@ +# Developer Operations at freeCodeCamp.org + +Dzi臋kujemy za zainteresowanie si臋 tym, jak robimy DevOps dla platformy na freeCodeCamp.org. + +Starali艣my si臋, aby j臋zyk w tym przewodniku by艂 jak najprostszy dla wszystkich. Znale藕膰 mo偶esz tutaj jednak techniczny 偶argon. Nie jest to wyczerpuj膮cy przewodnik po wszystkich operacjach i ma by膰 wykorzystywany tylko jako punkt odniesienia dla zrozumienia system贸w. + +## Jak budujemy i wdra偶amy baz臋 danych? + +Nieprzerwanie budujemy i wdra偶amy [`master`](https://github.com/freeCodeCamp/freeCodeCamp/tree/master), nasz domy艣lny dzia艂 rozwoju na osobnym zestawie serwer贸w**. + +Zazwyczaj ga艂膮藕 `master` jest 艂膮czona z ga艂臋zi膮 [`produkcyjny-stage`](https://github.com/freeCodeCamp/freeCodeCamp/tree/production-staging) raz dziennie i wydawana w izolowanej infrastrukturze. Nazywamy to nasz膮 aplikacj膮 "staging/beta". + +Jest ona identyczna z naszym 艣rodowiskiem produkcyjnym w `freeCodeCamp.org`, innym ni偶 wykorzystuj膮cym osobny zestaw baz danych, serwer贸w, web-proxy, itp. Ta izolacja pozwala nam testowa膰 ci膮g艂y rozw贸j i funkcje w scenariuszu "production like", bez wp艂ywu na zwyk艂ych u偶ytkownik贸w platform freeCodeCamp.org. + +Gdy tylko zesp贸艂 programist贸w [`@freeCodeCamp/dev-team`](https://github.com/orgs/freeCodeCamp/teams/dev-team/members) jest zadowolony ze zmian w aplikacji inscenizacyjnej, zmiany te s膮 przenoszone co kilka dni do 艣rodowiska [`production-current`](https://github.com/freeCodeCamp/freeCodeCamp/tree/production-current). Nast臋pnie wydajemy zmiany w naszych platformach na 偶ywo na freeCodeCamp.org. + +Stosujemy r贸偶ne poziomy test贸w integracyjnych i akceptacyjnych, aby sprawdzi膰 jako艣膰 kodu. Wszystkie nasze testy s膮 wykonywane za pomoc膮 oprogramowania, takiego jak Travis i Azure Pipelines. Niekt贸re z tych zautomatyzowanych, czyli po przeniesieniu zmian do odpowiedniego oddzia艂u, s膮 budowane i wdra偶ane na platformach. + +Zapraszamy do przetestowania tych wyda艅 w trybie **"public beta testing "** i uzyskania wczesnego dost臋pu do nadchodz膮cych funkcji na platformach. Czasami te funkcje/zmiany s膮 nazywane **nast臋pnymi, beta, etapami, ** itd. zamiennie. + +Tw贸j wk艂ad poprzez opinie i raporty o wydaniach pomo偶e nam uczyni膰 platformy produkcyjne na `freeCodeCamp.org` bardziej **odpornymi**, **zgodnymi** i **stabilnymi** dla ka偶dego. + +Dzi臋kujemy Ci za zg艂aszanie b艂臋d贸w, kt贸re napotykasz, pomagasz w ten spos贸b w ulepszaniu freeCodeCamp.org. Rz膮dzisz! + +## Identyfikacja nadchodz膮cej wersji platformy + +Nazwa domeny b臋dzie inna ni偶 **`freeCodeCamp.org`**. Obecnie ta publiczna wersja beta testowa jest dost臋pna na stronie diff --git a/docs/i18n-languages/polish/how-to-open-a-pull-request.md b/docs/i18n-languages/polish/how-to-open-a-pull-request.md new file mode 100644 index 0000000000..0135737d9a --- /dev/null +++ b/docs/i18n-languages/polish/how-to-open-a-pull-request.md @@ -0,0 +1,52 @@ + +| [Read these guidelines in other languages](/docs/i18n-languages) | +|-| + + +# Jak otworzy膰 Pull Request + +# Jak przygotowac dobr膮 nazw臋 Pull Request: + +Przy otwieraniu Pull Request(PR), u偶yj poni偶szej tabeli, aby zdecydowa膰, jaki tytu艂 ma nosi膰 Tw贸j PR w poni偶szym formacie: +`fix/feat/chore/refactor/docs/perf (zakres): Tytu艂 PR + +Przyk艂adem jest `fix(learn): Naprawiono testy dla do...while loop challenge`. + +| Scope | Documentation | +|---|---| +| `learn`,`curriculum` | For Pull Requests making changes to the curriculum challenges. | +| `client` | For Pull Requests making changes to client platform logic or user interface | +| `guide` | For Pull Requests which make changes to the guide. | +| `docs` | For Pull Requests making changes to the project's documentation. | + + +# Gdy proponuijesz Pull Request (PR) + +1. Po dokonaniu edycji zostanie wy艣wietlony monit o utworzenie 偶膮dania przeci膮gni臋cia na stronie GitHub widelca. + + [Obraz - Por贸wnaj pro艣b臋 o wyci膮gni臋cie na GitHub](/docs/images/github/compare-pull-request-prompt.png) + +2. Domy艣lnie, wszystkie 偶膮dania pobrania powinny by膰 skierowane przeciwko g艂贸wnemu repo freeCodeCamp, ga艂臋zi `master`. + + Upewnij si臋, 偶e tw贸j widelec bazowy jest ustawiony na freeCodeCamp/freeCodeCamp podczas podnoszenia 偶膮dania przeci膮gni臋cia. + + ![Obraz - por贸wnywanie widelc贸w podczas sk艂adania 偶膮dania ci膮gni臋cia](/docs/images/github/comparing-forks-for-pull-request.png) + +3. Wy艣lij 偶膮danie 艣ci膮gni臋cia z ga艂ezi do ga艂臋zi `mastera` freeCodeCamp. + +4. W tre艣ci swojego PR zamie艣膰 bardziej szczeg贸艂owe podsumowanie wprowadzonych przez Ciebie zmian i dlaczego. + + - Otrzymasz szablon wniosku o pull request. Jest to lista kontrolna, kt贸r膮 powiniene艣 by艂 zastosowa膰 przed otwarciem pull request. + + - Wype艂nij szczeg贸艂y, kt贸re wydaj膮 Ci si臋 pasowa膰. Informacje te zostan膮 zweryfikowane i zadecyduj膮, czy wniosek o pull request zostanie przyj臋ty, czy te偶 nie. + + - Je艣li PR ma na celu naprawienie istniej膮cego b艂臋du/sprawy, to na ko艅cu + opis Twojego PR, dodaj s艂owo kluczowe `zamkni臋cia`i#xxxxxx (gdzie xxxx + jest numerem wydania). Przyk艂ad: `zamkni臋cie #1337`. To m贸wi GitHub, aby + automatycznie zamyka istniej膮c膮 spraw臋, je艣li PR zostanie zaakceptowany i po艂膮czony. + +5. Wskaza膰, czy testowa艂e艣 na lokalnej kopii strony, czy te偶 nie. + + Jest to bardzo wa偶ne, gdy dokonujesz zmian, kt贸re nie ograniczaj膮 si臋 jedynie do edycji tre艣ci tekstowych, takich jak artyku艂 w Przewodniku. Przyk艂ady zmian wymagaj膮cych lokalnego testowania to JavaScript, CSS lub HTML, kt贸re mog膮 zmieni膰 funkcjonalno艣膰 lub uk艂ad strony. + + diff --git a/docs/i18n-languages/polish/how-to-work-on-coding-challenges.md b/docs/i18n-languages/polish/how-to-work-on-coding-challenges.md new file mode 100644 index 0000000000..1d84d73fab --- /dev/null +++ b/docs/i18n-languages/polish/how-to-work-on-coding-challenges.md @@ -0,0 +1,337 @@ + +| [Read these guidelines in other languages](/docs/i18n-languages) | +|-| + + +# How to work on coding challenges + +Naszym celem jest rozw贸j zabawnego i przejrzystego do艣wiadczenia interaktywnego uczenia si臋. + +Projektowanie interaktywnych wyzwa艅 zwi膮zanych z kodowaniem jest trudne. Du偶o 艂atwiej by艂oby napisa膰 d艂ugie wyja艣nienia lub stworzy膰 samouczek wideo, a jest miejsce dla tych na Medium i YouTube. Jednak偶e, je艣li chodzi o nasz podstawowy program nauczania, trzymamy si臋 tego, co dzia艂a najlepiej dla wi臋kszo艣ci ludzi - w pe艂ni interaktywnego, przypominaj膮cego gr臋 wideo do艣wiadczenia. + +Chcemy, aby obozowicze osi膮gn臋li stan przep艂ywu. Chcemy, aby zbudowali rozmach i prze艣lizgn臋li si臋 przez nasz program nauczania z jak najmniejsz膮 liczb膮 rozd藕wi臋k贸w. Chcemy, aby uczestniczyli w projektach z pewno艣ci膮 siebie i z szerok膮 ekspozycj膮 na koncepcje programowania. + +Stworzenie tych wyzwa艅 wymaga ogromnej kreatywno艣ci i dba艂o艣ci o szczeg贸艂y. Ale b臋dziesz mia艂 mn贸stwo pomocy. Masz wsparcie ca艂ego zespo艂u wsp贸艂pracownik贸w, od kt贸rych mo偶esz odbija膰 pomys艂y i demo swoich wyzwa艅. B膮d藕 aktywny w [pokoju wsp贸艂pracownik贸w](https://gitter.im/freecodecamp/contributors) i zadawaj wiele pyta艅. + +Z Twoj膮 pomoc膮 mo偶emy zaprojektowa膰 interaktywny program nauczania kodowania, kt贸ry pomo偶e milionom ludzi nauczy膰 si臋 kodowania przez kolejne lata. + +Zawarto艣膰 ka偶dego wyzwania jest przechowywana w jego w艂asnym pliku markdown. Plik ten jest p贸藕niej publikowany przy u偶yciu naszych narz臋dzi, na stronie internetowej, z kt贸r膮 mo偶na si臋 komunikowa膰. Mo偶esz znale藕膰 ca艂膮 zawarto艣膰 programu nauczania freeCodeCamp.org w katalogu [`/curriculum`](/curriculum). + +Istniej膮 dwa sposoby pracy nad tymi wyzwaniami: + +- Polecamy, sklonuj projekt i edytuj lokalnie na swoim komputerze. Aby uzyska膰 pomoc, przeczytaj nasze [wytyczne tutaj](/CONTRIBUTING.md). +- Mo偶esz te偶 opcjonalnie zmodyfikowa膰 wyzwanie w interfejsie GitHub, klikaj膮c ikon臋 o艂贸wka, aby rozpocz膮膰 edycj臋 pliku. + +## Szablon wyzwania + +Poni偶ej znajduje si臋 szablon tego, jak wygl膮daj膮 pliki markdown wyzwa艅. + +Uwagi:**Notatki:** + +1. In the below sections, examples of `{ext}` are: + - `html` - HTML/CSS + - `js` - JavaScript + - `jsx` - JSX + +2. For the `Tests` section below, `text` and `testString` should be valid YAML strings. `testString` can be a stringified function or expression possibly using Chai asserts. + +````md +--- +id: Unique identifier (alphanumerical, MongoDB_id) +title: Challenge Title +challengeType: 0 +videoUrl: 'url of video explanation' +--- + +## Description +
+A Description of the challenge and what is required to pass +
+ +## Instructions +
+Instructions about what exactly needs to be done. +
+ +## Tests +
+ +``` yml +tests: + - text: Should return "foo" + testString: 'A stringified function possibly using Chai asserts' +``` + +
+ +## Challenge Seed +
+ +
+ +```{ext} +Code displayed in the editor by default. + +This is a required section for the challenge. +``` + +
+ +### Before Test +
+ +```{ext} +Optional Test setup code. +``` + +
+ +### After Test +
+ +```{ext} +Optional Test tear down code. +``` + +
+ +
+ +## Solution +
+ +```{ext} +// solution required +``` + +
+```` + + +# Numbering Challenges + +Ka偶de wyzwanie wymaga "pomocy". Je艣li go nie okre艣lisz, wtedy MongoDB utworzy nowy losowy, kiedy zapisze dane, jednak nie chcemy, aby to zrobi艂, poniewa偶 chcemy, aby wyzwania ids by艂y sp贸jne w r贸偶nych 艣rodowiskach (etapy, produkcja, wiele r贸偶nych programist贸w, itp.). + +Aby wygenerowa膰 nowy w pow艂oce (zak艂adaj膮c, 偶e MongoDB dzia艂a osobno): + + +1. Run `mongo` command +2. Run `ObjectId()` command + +For example: + +```bash +$ mongo +MongoDB shell version v3.6.1 +connecting to: mongodb://127.0.0.1:27017 +MongoDB server version: 3.4.10 +... +$ ObjectId() +ObjectId("5a474d78df58bafeb3535d34") +``` + +The result is a new id, for example `5a474d78df58bafeb3535d34` above. + +Once you have your id, put it into the markdown file as the `id` field at the top, e.g. + +```yml +--- +id: 5a474d78df58bafeb3535d34 +title: Challenge Title +``` +# Naming challenges + +Nazywanie rzeczy jest trudne. U艂atwili艣my to poprzez na艂o偶enie pewnych ogranicze艅. + +Wszystkie tytu艂y konkursowe powinny by膰 jednoznaczne i powinny by膰 zgodne z tym schematem: + +[czasownik] [klauzula obiektowa] + +Oto kilka przyk艂adowych nazw wyzwa艅: + +- U偶yj zgodnie z ruchem wskaz贸wek zegara, aby okre艣li膰 wype艂nienie elementu +- Tablice kondensacyjne z funkcj膮 .reduce +- U偶yj notacji wspornikowej, aby znale藕膰 pierwszy znak w 艂a艅cuchu. + + +# Writing challenge descriptionss/instructions (Pisanie opis贸w/instrukcji wyzwa艅) + +Zdania powinny by膰 jasne i zwi臋z艂e z minimalnym 偶argonem. Je艣li jest u偶ywany, 偶argon powinien by膰 natychmiast zdefiniowany w prostym j臋zyku angielskim. + +Zachowaj kr贸tkie akapity (oko艂o 1-4 zda艅). Ludzie cz臋艣ciej czytaj膮 kilka kr贸tkich akapit贸w nad 艣cian膮 tekstu. + +Tekst wyzwania powinien wykorzystywa膰 drug膮 osob臋 ("ty"), aby nada膰 mu ton rozmowy. W ten spos贸b tekst i instrukcje wydaj膮 si臋 przemawia膰 bezpo艣rednio do osoby prowadz膮cej kamper, kt贸ra pracuje nad wyzwaniem. Starajmy si臋 unika膰 u偶ywania pierwszej osoby ("ja", "my", "pozw贸lmy" i "nas"). + + +Nie u偶ywaj link贸w wychodz膮cych. Przerywaj膮 one przep艂yw. A kempingowicze nie powinni mie膰 nigdy obowi膮zku googlowania czegokolwiek podczas tych wyzwa艅. Je艣li istniej膮 zasoby, z kt贸rych wed艂ug ciebie kamperzy skorzystaj膮, dodaj je do artyku艂u po艣wi臋conego wytycznym. + +Mo偶esz dodawa膰 wykresy, je艣li jest to absolutnie konieczne. + +freeCodeCamp ma globaln膮 spo艂eczno艣膰, a kulturowe znaczenie emoji lub emotikonu mo偶e by膰 inne na ca艂ym 艣wiecie. Ponadto, emojis mo偶e by膰 r贸偶nie renderowane na r贸偶nych systemach. + +W艂a艣ciwe rzeczowniki powinny u偶ywa膰 poprawnej kapitalizacji, gdy jest to mo偶liwe. Poni偶ej znajduje si臋 lista s艂贸w, kt贸re powinny pojawi膰 si臋 w wyzwaniach. + +- JavaScript (du偶e litery w "J" i "S" i brak skr贸t贸w) +- Node.js +- Rozw贸j front-endu (forma przymiotnikowa z my艣lnikiem) ma miejsce, gdy pracujesz na froncie (forma rzeczownika bez my艣lnika). To samo dotyczy termin贸w "back end", "full stack" i wielu innych termin贸w z艂o偶onych. + +##### Zasada 2-minutowa + +Ka偶de wyzwanie powinno by膰 mo偶liwe do rozwi膮zania w ci膮gu 120 sekund przez osob臋 pos艂uguj膮c膮 si臋 j臋zykiem angielskim, kt贸ra uko艅czy艂a zadania prowadz膮ce do jego realizacji. Obejmuje to czas potrzebny na przeczytanie wskaz贸wek/instrukcji, zrozumienie kodu 藕r贸d艂owego, napisanie w艂asnego kodu i przej艣cie wszystkich test贸w. + +Je艣li uko艅czenie zadania trwa d艂u偶ej ni偶 dwie minuty, masz dwie mo偶liwo艣ci: + +- Upro艣膰 zadanie, lub +- Podziel wyzwanie na dwa wyzwania. + +Zasada 2-minutowa zmusza Ci臋, projektanta wyzwa艅, do zwi臋z艂ego okre艣lenia kierunku, kodu nasion i prostych test贸w. + +Mamy wydarzenia w j臋zyku JavaScript, kt贸re 艣ledz膮, ile czasu zajmuje kamperom rozwi膮zywanie wyzwa艅 i mo偶emy je wykorzysta膰 do identyfikacji wyzwa艅, kt贸re nale偶y upro艣ci膰 lub podzieli膰. + +##### Modu艂owo艣膰 + +Ka偶de wyzwanie powinno nauczy膰 dok艂adnie jednej koncepcji, a koncepcja ta powinna wynika膰 z nazwy wyzwania. + +Mo偶emy wzmocni膰 wcze艣niej om贸wione koncepcje poprzez powtarzanie i wariacje - na przyk艂ad poprzez wprowadzenie element贸w h1 w jednym wyzwaniu, a nast臋pnie element贸w h3 p贸藕niej kilka wyzwa艅. + +Naszym celem jest stawienie czo艂a tysi膮com dwuminutowych wyzwa艅. Mog膮 one przep艂ywa膰 razem i powtarza膰 wcze艣niej om贸wione koncepcje. + +#### Formatowanie tekstu wyzwania + +Oto szczeg贸艂owe wytyczne dotycz膮ce formatowania tekstu wyzwania i przyk艂ad贸w: + +- S艂owa kluczowe w j臋zyku id膮 w znacznikach ``. Na przyk艂ad, nazwy tag贸w HTML lub nazwy w艂a艣ciwo艣ci CSS. +- Pierwsza instancja s艂owa kluczowego, gdy jest ono definiowane, lub og贸lne s艂owa kluczowe (np. "obiekt" lub "niezmienny") znajduj膮 si臋 w znacznikach ``. +- Odniesienia do cz臋艣ci kodu (np. funkcja, metoda lub nazwa zmiennej) powinny by膰 opakowane w znaczniki ``. Zobacz przyk艂ad poni偶ej: +- U偶yj parseInt aby przekonwertowa膰 zmienn膮 realNumber na liczb臋 ca艂kowit膮. +- Wielowierszowe bloki kodu **musz膮 by膰 poprzedzone pustym wierszem**. Nast臋pny wiersz musi zaczyna膰 si臋 od trzech wierszy wstecznych, po kt贸rych natychmiast nast臋puje jeden z [obs艂ugiwanych j臋zyk贸w](https://prismjs.com/#supported-languages). Aby doko艅czy膰 blok kodu, musisz uruchomi膰 now膮 lini臋, kt贸ra ma tylko trzy backticka i **inn膮 pust膮 lini臋**. +**Uwaga:** Je艣li zamierzasz u偶y膰 przyk艂adowego kodu w YAML, u偶yj `yaml` zamiast `yml` dla j臋zyka po prawej stronie ty艂k贸w. + +Zobacz przyk艂ad poni偶ej: + +````md +The following is an example of code: + +```{language} + +[YOUR CODE HERE] + +``` +```` + +- Dodatkowe informacje w formie notatki powinny by膰 sformatowane `Note: Pozosta艂a cz臋艣膰 tekstu notatki...` +- Je艣li potrzebnych jest wiele notatek, w贸wczas wszystkie notatki nale偶y wymieni膰 w osobnych zdaniach w formacie `Notes:Pierwsza notatka. Druga notatka text.`. +- U偶ywaj cudzys艂ow贸w podw贸jnych tam, gdzie ma to zastosowanie. + +# Writing tests + +Wyzwania powinny mie膰 minimaln膮 liczb臋 test贸w niezb臋dnych do sprawdzenia, czy kamper rozumie koncepcj臋. + +Naszym celem jest przekazanie jednego punktu, kt贸rego wyzwanie stara si臋 nauczy膰, i sprawdzenie, czy zrozumieli ten punkt. + +Testy wyzwa艅 mog膮 wykorzystywa膰 biblioteki asertywne Node.js i Chai.js. Ponadto, w razie potrzeby, kod wygenerowany przez u偶ytkownika mo偶e by膰 dost臋pny w zmiennej `code`. + +## Formatowanie kodu nasion + +Oto szczeg贸艂owe wytyczne dotycz膮ce formatowania kodu nasion wyzwania: + +- U偶yj dw贸ch spacji do wci臋膰 +- Wypowiedzi w j臋zyku JavaScript ko艅cz膮 si臋 znakiem 艣rednika. +- W stosownych przypadkach nale偶y stosowa膰 podw贸jne cudzys艂owy. +- Komentarze powinny mie膰 odst臋p mi臋dzy znakami komentarza a samym komentarzem. + + "/// Napraw t臋 lini臋 + +# Curriculum Challenge Hints and Solutions (Wyzwania programowe) + +Ka偶de wyzwanie posiada przycisk `Uzyskaj podpowied藕`, dzi臋ki czemu u偶ytkownik ma dost臋p do wszelkich podpowiedzi/rozwi膮za艅, kt贸re zosta艂y stworzone dla wyzwania. Tematy podpowiedzi/rozwi膮za艅 programowych znajduj膮 si臋 na [naszym forum](https://www.freecodecamp.org/forum/c/guide) pod kategori膮 `Guide`. + +Je艣li znajdziesz problem z istniej膮cym tematem podpowiedzi/rozwi膮za艅 wyzwania, mo偶esz zg艂osi膰 sugestie w komentarzach poni偶ej g艂贸wnego postu wiki, je艣li jeste艣 co najmniej u偶ytkownikiem forum poziomu 3. Wybierz moderator贸w, kt贸rzy zapoznaj膮 si臋 z komentarzami i zdecyduj膮, czy w艂膮czy膰 zmiany w istniej膮cym temacie. + +##### Dodawanie nowych podpowiedzi/rozwi膮za艅 na temat wyzwa艅 + +Tylko moderatorzy mog膮 dodawa膰 nowe podpowiedzi i rozwi膮zania, gdy do programu nauczania dodawane s膮 nowe wyzwania. + +Podejmij nast臋puj膮ce kroki podczas dodawania nowych podpowiedzi/rozwi膮za艅 zwi膮zanych z tematem zwi膮zanym z wyzwaniami. + +1. Rozpocznij od wykonania tych samych krok贸w w przypadku [tworzenia nowego tematu] (tworzenie nowego przewodnika tematycznego), a nast臋pnie przejrzyj nast臋pny etap tworzenia tytu艂u. +2. Tytu艂 tematu powinien zaczyna膰 si臋 od "freeCodeCamp Challenge Guide: W tym celu nale偶y zacz膮膰 od "freeCamp Challenge Guide: "freeCamp Challenge Guide: FreeCamp Challenge Guide: FreeCamp Challenge Guide: FreeCamp Challenge Guide: FreeCamp Challenge Guide: FreeCamp Challenge Guide: FreeCamp Challenge Guide. Na przyk艂ad, je艣li wyzwanie nosi nazw臋 "Chunky Monkey", tytu艂 tematu brzmia艂by "freeCodeCamp Challenge Guide": Chunky Monkey". +3. 3. `camperbot` powinien by膰 w艂a艣cicielem tych temat贸w/poczt贸w, wi臋c b臋dziesz musia艂 poprosi膰 administratora o zmian臋 w艂asno艣ci g艂贸wnego postu na `camperbot`. +4. Po utworzeniu nowego tematu, tworzony jest identyfikator tematu forum. Znajduje si臋 on na ko艅cu adresu URL tematu forum. Ten identyfikator musi by膰 dodany do frontmaterii pliku wyzwania programu nauczania poprzez normalny proces pull request dla przycisku "Uzyskaj podpowied藕", aby po艂膮czy膰 si臋 z tematem. + +#### Wytyczne dotycz膮ce tre艣ci podpowiedzi i rozwi膮za艅 temat贸w + +W przypadku proponowania rozwi膮zania dla tematu przewodnika zwi膮zanego z wyzwaniem programowym, nale偶y doda膰 pe艂ny kod. Obejmuje on wszystkie oryginalne kody zal膮偶kowe oraz wszelkie zmiany potrzebne do przej艣cia wszystkich test贸w na wyzwania. Poni偶szy szablon powinien by膰 u偶ywany podczas tworzenia nowych podpowiedzi/rozwi膮za艅 tematycznych: + +````md +# Challenge Name Goes Here + +--- +## Problem Explanation + +This summarizes what need to be done without just restating the challenge description and/or instructions. This is an optional section + +#### Relevant Links +- [Link Text](link_url_goes_here) +- [Link Text](link_url_goes_here) + +--- +## Hints + +### Hint 1 +Hint goes here + +### Hint 2 +Hint goes here + +--- +## Solutions + +
Solution 1 (Click to Show/Hide) + +```js +function myFunc() { + console.log('Hello World!'); +} +``` + +#### Code Explanation + +- Code explanation goes here +- Code explanation goes here + +#### Relevant Links + +- [Link Text](link_url_goes_here) +- [Link Text](link_url_goes_here) + +
+```` +# Testowanie wyzwa艅 + +Przed utworzeniem [pro艣by o wyci膮gni臋cie](how-to-open-a-pull-request.md) dla Twoich zmian, musisz sprawdzi膰, czy wprowadzone zmiany nie powoduj膮 nieumy艣lnie problem贸w z wyzwaniem. Aby przetestowa膰 wszystkie wyzwania, nale偶y wykona膰 "test npm run test:curriculum". Aby zaoszcz臋dzi膰 czas mo偶esz ograniczy膰 testy do jednego wyzwania wykonuj膮c nast臋puj膮ce kroki: + +1. W pliku `.env` ustaw zmienn膮 艣rodowiskow膮 `TEST_CHALLENGES_FOR_LANGS` na j臋zyk wyzwania (wyzwa艅), kt贸re musisz przetestowa膰. Obecnie akceptowane warto艣ci to `angielski`, `arabski`, `chi艅ski`, `portugalski`, `rosyjski` i `hiszpa艅ski`. + +2. Prze艂膮czy膰 do katalogu `curriculum`: + +``` + cd program nauczania +``` + +3. Wykonaj nast臋puj膮ce czynno艣ci dla ka偶dego pliku wyzwania, dla kt贸rego zmieni艂e艣 dowolny `testString`s lub dodane rozwi膮zania: + +``` +npm run test -- -g 'pe艂ny angielski tytu艂 wyzwania'. +``` + +Po sprawdzeniu, 偶e ka偶de wyzwanie, nad kt贸rym pracowa艂e艣, przejdzie pomy艣lnie testy, prosimy o stworzenie wniosku o ci膮gni臋cie. + +#### Przydatne linki + +Tworzenie i edycja wyzwa艅: + +1. Typy wyzwa艅](https://github.com/freeCodeCamp/learn/blob/a5cb25704168aa37f59a582f0bb5a19b7bd89b46/utils/challengeTypes.js) - co oznaczaj膮 liczbowe warto艣ci typu wyzwania (wyliczenie). + +2. [Przyczyniaj膮c si臋 do FreeCodeCamp - Writing ES6 Challenge Tests ](https://www.youtube.com/watch?v=iOdD84OSfAE#t=2h49m55s) - film video po [Ethan Arrowood](https://twitter.com/ArrowoodTech) jako wk艂ad do starej wersji programu nauczania. +