add polish translation for help-fastapi section

docs/pl/docs/help-fastapi.md

@@ -0,0 +1,265 @@
+# Pomóc FastAPI - Uzyskać pomoc
+
+Czy podoba Ci się **FastAPI**?
+
+Czy chciałbyś pomóc FastAPI, jego użytkownikom i autorowi?
+
+Może napotkałeś trudności z  **FastAPI** i potrzebujesz pomocy?
+
+Istnieje kilka bardzo łatwych sposobów, aby pomóc (czasami wystarczy jedno lub dwa kliknięcia).
+
+Istnieje również kilka sposobów uzyskania pomocy.
+
+## Zapisz się do newslettera
+
+Możesz zapisać się do rzadkiego [newsletter **FastAPI i jego przyjaciele**](/newsletter/){.internal-link target=_blank} i być na bieżąco z:
+
+* Aktualnościami o FastAPI i przyjaciołach 🚀
+* Przewodnikami 📝
+* Funkcjami ✨
+* Zmianami łamiącymi kompatybilność 🚨
+* Poradami i sztuczkami ✅
+
+## Śledź FastAPI na Twitterze
+
+<a href="https://twitter.com/fastapi" class="external-link" target="_blank">Śledź @fastapi na **Twitterze**</a> aby być na bieżąco z najnowszymi wiadomościami o **FastAPI**. 🐦
+
+## Dodaj gwiazdkę **FastAPI** na GitHubie
+
+Możesz "dodać gwiazdkę" FastAPI na GitHubie (klikając przycisk gwiazdki w prawym górnym rogu): <a href="https://github.com/tiangolo/fastapi" class="external-link" target="_blank">https://github.com/tiangolo/fastapi</a>. ⭐️
+
+Dodając gwiazdkę, inni użytkownicy będą mogli łatwiej znaleźć projekt i zobaczyć, że był już przydatny dla innych.
+
+## Obserwuj repozytorium GitHub w poszukiwaniu nowych wydań
+
+Możesz "obserwować" FastAPI na GitHubie (klikając przycisk "obserwuj" w prawym górnym rogu): <a href="https://github.com/tiangolo/fastapi" class="external-link" target="_blank">https://github.com/tiangolo/fastapi</a>. 👀
+
+Tam możesz wybrać opcję "Tylko wydania".
+
+Dzięki temu będziesz otrzymywać powiadomienia (na swój adres e-mail) za każdym razem, gdy pojawi się nowe wydanie (nowa wersja) **FastAPI** z poprawkami błędów i nowymi funkcjami.
+
+## Skontaktuj się z autorem
+
+Możesz skontaktować się ze <a href="https://tiangolo.com" class="external-link" target="_blank">mną (Sebastián Ramírez / `tiangolo`)</a>, autorem.
+
+Możesz:
+
+* <a href="https://github.com/tiangolo" class="external-link" target="_blank">Śledzić mnie na **GitHubie**</a>.
+    * Zobaczyć inne projekty Open Source, które stworzyłem, które mogą Ci pomóc.
+    * Śledzić mnie, aby zobaczyć, kiedy tworzę nowy projekt Open Source.
+* <a href="https://twitter.com/tiangolo" class="external-link" target="_blank">Śledzić mnie na **Twitterze**</a> lub <a href="https://fosstodon.org/@tiangolo" class="external-link" target="_blank">Mastodon</a>.
+    * Powiedz mi, jak korzystasz z FastAPI (uwielbiam to słyszeć).
+    * Dowiedz się, kiedy ogłaszam coś nowego lub wypuszczam nowe narzędzia.
+    * Możesz także <a href="https://twitter.com/fastapi" class="external-link" target="_blank">śledzić @fastapi na Twitterze</a> (to oddzielne konto).
+* <a href="https://www.linkedin.com/in/tiangolo/" class="external-link" target="_blank">Połącz się ze mną na **Linkedin**</a>.
+    * Dowiedz się, kiedy ogłaszam coś nowego lub wypuszczam nowe narzędzia (chociaż częściej korzystam z Twittera 🤷‍♂).
+* Czytaj, co piszę (lub śledź mnie) na <a href="https://dev.to/tiangolo" class="external-link" target="_blank">**Dev.to**</a> lub <a href="https://medium.com/@tiangolo" class="external-link" target="_blank">**Medium**</a>.
+    * Czytaj inne pomysły, artykuły i dowiedz się o narzędziach, które stworzyłem.
+    * Śledź mnie, aby przeczytać, kiedy publikuję coś nowego.
+
+## Tweetnij o **FastAPI**
+
+<a href="https://twitter.com/compose/tweet?text=I'm loving @fastapi because... https://github.com/tiangolo/fastapi" class="external-link" target="_blank">Tweetnij o **FastAPI**</a> i daj mi i innym znać, dlaczego Ci się podoba. 🎉
+
+Uwielbiam słyszeć, jak **FastAPI** jest używane, co Ci się w nim podobało, w jakim projekcie/firmie go używasz itp.
+
+## Głosuj na FastAPI
+
+* <a href="https://www.slant.co/options/34241/~fastapi-review" class="external-link" target="_blank">Głosuj na **FastAPI** w Slant</a>.
+* <a href="https://alternativeto.net/software/fastapi/" class="external-link" target="_blank">Głosuj na **FastAPI** w AlternativeTo</a>.
+* <a href="https://stackshare.io/pypi-fastapi" class="external-link" target="_blank">Powiedz, że używasz **FastAPI** na StackShare</a>.
+
+## Pomagaj innym z pytaniami w GitHub
+
+Możesz spróbować pomóc innym w ich pytaniach na:
+
+* <a href="https://github.com/tiangolo/fastapi/discussions/categories/questions?discussions_q=category%3AQuestions+is%3Aunanswered" class="external-link" target="_blank">Dyskusjach na GitHubie</a>
+* <a href="https://github.com/tiangolo/fastapi/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3Aquestion+-label%3Aanswered+" class="external-link" target="_blank">Problemach na GitHubie</a>
+
+W wielu przypadkach możesz już znać odpowiedź na te pytania. 🤓
+
+Jeśli pomagasz wielu ludziom z ich pytaniami, zostaniesz oficjalnym [Ekspertem FastAPI](fastapi-people.md#experts){.internal-link target=_blank}. 🎉
+
+Pamiętaj tylko, że najważniejsze jest: starać się być życzliwym. Ludzie przychodzą z frustracjami i w wielu przypadkach nie pytają w najlepszy sposób, ale postaraj się być jak najbardziej życzliwy. 🤗
+
+Idea polega na tym, aby społeczność **FastAPI** była życzliwa i przyjazna. Jednocześnie nie akceptuj prześladowania ani braku szacunku wobec innych. Musimy dbać o siebie nawzajem.
+
+---
+
+Oto, jak pomóc innym z pytaniami (w dyskusjach lub problemach):
+
+### Zrozum pytanie
+
+* Sprawdź, czy rozumiesz **cel** i przypadki użycia osoby pytającej.
+
+* Następnie sprawdź, czy pytanie (większość to pytania) jest **jasne**.
+
+* W wielu przypadkach zadane pytanie dotyczy wyimaginowanego rozwiązania użytkownika, ale może istnieć **lepsze** rozwiązanie. Jeśli lepiej zrozumiesz problem i przypadki użycia, być może będziesz mógł zaproponować lepsze **alternatywne rozwiązanie**.
+
+* Jeśli nie rozumiesz pytania, poproś o więce **szczegółów**.
+
+### Odtwórz problem
+
+W większości przypadków i pytań jest coś związanego z **oryginalnym kodem** osoby pytającej.
+
+W wielu przypadkach skopiują tylko fragment kodu, ale to nie wystarczy, aby **odtworzyć problem**.
+
+* Możesz poprosić ich o dostarczenie <a href="https://stackoverflow.com/help/minimal-reproducible-example" class="external-link" target="_blank">minimalnego, odtwarzalnego przykładu</a>, który możesz **skopiować i wkleić** i uruchomić lokalnie, aby zobaczyć ten sam błąd lub zachowanie, które widzą, lub lepiej zrozumieć ich przypadki użycia.
+
+* Jeśli jesteś szczególnie hojny, możesz spróbować **stworzyć taki przykład** samodzielnie, opierając się tylko na opisie problemu. Miej na uwadze, że może to zająć dużo czasu i lepiej poprosić ich o wyjaśnienie problemu.
+
+### Proponuj rozwiązania
+
+* Po zrozumieniu pytania możesz podać im możliwą **odpowiedź**.
+
+* W wielu przypadkach lepiej zrozumieć ich **podstawowy problem lub przypadki użycia**, ponieważ może istnieć lepszy sposób rozwiązania niż to, co próbują zrobić.
+
+### Poproś o zamknięcie
+
+Jeśli odpowiedzą, jest duża szansa, że rozwiązałeś ich problem, gratulacje, **jesteś bohaterem**! 🦸
+
+* Teraz, jeśli to rozwiązało ich problem, możesz poprosić ich o:
+
+    * W Dyskusjach na GitHubie: oznaczenie komentarza jako **odpowiedź**.
+    * W Problemach na GitHubie: **zamknięcie** problemu.
+
+## Obserwuj repozytorium na GitHubie
+
+Możesz "obserwować" FastAPI na GitHubie (klikając przycisk "obserwuj" w prawym górnym rogu): <a href="https://github.com/tiangolo/fastapi" class="external-link" target="_blank">https://github.com/tiangolo/fastapi</a>. 👀
+
+Jeśli wybierzesz "Obserwuj" zamiast "Tylko wydania", otrzymasz powiadomienia, gdy ktoś utworzy nowy problem lub pytanie. Możesz również określić, że chcesz być powiadamiany tylko o nowych problemach, dyskusjach, PR-ach itp.
+
+Następnie możesz spróbować pomóc im rozwiązać te pytania.
+
+## Zadawaj pytania
+
+Możesz <a href="https://github.com/tiangolo/fastapi/discussions/new?category=questions" class="external-link" target="_blank">utworzyć nowe pytanie</a> w repozytorium na GitHubie, na przykład aby:
+
+* Zadać **pytanie** lub zapytać o **problem**.
+* Zaproponować nową **funkcję**.
+
+**Uwaga**: jeśli to zrobisz, poproszę Cię również o pomoc innym. 😉
+
+## Przeglądaj Pull Requests
+
+Możesz pomóc mi w przeglądaniu żądań ściągnięcia od innych.
+
+Ponownie, proszę, postaraj się być jak najbardziej życzliwy. 🤗
+
+---
+
+Oto, co warto mieć na uwadze i jak przeglądać pull request:
+
+### Zrozum problem
+
+* Najpierw upewnij się, że **rozumiesz problem**, który próbuje rozwiązać żądanie ściągnięcia. Może on mieć dłuższą dyskusję w Dyskusji na GitHubie lub w problemie.
+
+* Jest też duża szansa, że żądanie ściągnięcia nie jest tak naprawdę potrzebne, ponieważ problem można rozwiązać w **inny sposób**. Wtedy możesz to zasugerować lub zapytać o to.
+
+### Nie martw się stylem
+
+* Nie martw się zbytnio rzeczami takimi jak style wiadomości commitów, scalę i połączę je ręcznie, dostosowując commit.
+
+* Nie martw się również zasadami stylu, istnieją już zautomatyzowane narzędzia sprawdzające to.
+
+A jeśli istnieje jakaś inna potrzeba dotycząca stylu lub spójności, poproszę bezpośrednio o to, lub dodam commity z potrzebnymi zmianami.
+
+### Sprawdź kod
+
+* Sprawdź i przeczytaj kod, zobacz, czy ma sens, **uruchom go lokalnie** i zobacz, czy faktycznie rozwiązuje problem.
+
+* Następnie **skomentuj**, mówiąc, że to zrobiłeś, dzięki temu będę wiedział, że naprawdę to sprawdziłeś.
+
+!!! info
+    Niestety, nie mogę po prostu ufać PR-om, które mają kilka zatwierdzeń.
+
+    Kilka razy zdarzyło się, że są PR-y z 3, 5 lub więcej zatwierdzeniami, prawdopodobnie dlatego, że opis jest pociągający, ale gdy sprawdzam PR-y, są one faktycznie uszkodzone, mają błąd lub nie rozwiązują problemu, który twierdzą, że rozwiązują. 😅
+
+    Dlatego naprawdę ważne jest, abyś faktycznie przeczytał i uruchomił kod oraz dał mi znać w komentarzach, że to zrobiłeś. 🤓
+
+* Jeśli PR można uprościć w jakiś sposób, możesz o to poprosić, ale nie ma potrzeby być zbyt wybrednym, może być wiele subiektywnych punktów widzenia (a ja też będę miał swoje 🙈), więc lepiej, jeśli skupisz się na podstawowych rzeczach.
+
+### Testy
+
+* Pomóż mi sprawdzić, czy PR ma **testy**.
+
+* Sprawdź, czy testy **nie przechodzą** przed PR. 🚨
+
+* Następnie sprawdź, czy testy **przechodzą** po PR. ✅
+
+* Wiele PR-ów nie ma testów, możesz przypomnieć im o dodaniu testów, a nawet **przypomnieć** im o dodaniu testów, a nawet **zaproponować** samemu jakieś testy. To jedna z rzeczy, które pochłaniają najwięcej czasu, i możesz w tym bardzo pomóc.
+
+* Następnie skomentuj również, co próbowałeś, wtedy będę wiedział, że to sprawdziłeś. 🤓
+
+## Utwórz Pull Request
+
+Możesz [przyczynić się](contributing.md){.internal-link target=_blank} do kodu źródłowego za pomocą Pull Requestu, na przykład:
+
+* Aby naprawić literówkę, którą znalazłeś w dokumentacji.
+* Aby podzielić się artykułem, filmem lub podcastem, który stworzyłeś lub znalazłeś na temat FastAPI, <a href="https://github.com/tiangolo/fastapi/edit/master/docs/en/data/external_links.yml" class="external-link" target="_blank">edytując ten plik</a>.
+    * Upewnij się, że dodajesz swój link na początek odpowiedniej sekcji.
+* Aby pomóc w [tłumaczeniu dokumentacji](contributing.md#translations){.internal-link target=_blank} na Twój język.
+    * Możesz również pomóc w recenzji tłumaczeń stworzonych przez innych.
+* Aby zaproponować nowe sekcje dokumentacji.
+* Aby naprawić istniejący problem/błąd.
+    * Upewnij się, że dodajesz testy.
+* Aby dodać nową funkcję.
+    * Upewnij się, że dodajesz testy.
+    * Upewnij się, że dodajesz dokumentację, jeśli jest to istotne.
+
+## Pomóż w utrzymaniu FastAPI
+
+Pomóż mi utrzymać **FastAPI**! 🤓
+
+Jest wiele pracy do zrobienia, a w większości przypadków **TY** możesz to zrobić.
+
+Główne zadania, które możesz wykonać teraz to:
+
+* [Pomoc innym z pytaniami na GitHubie](#help-others-with-questions-in-github){.internal-link target=_blank} (zobacz powyższą sekcję).
+* [Przeglądaj Pull Requesty](#review-pull-requests){.internal-link target=_blank} (zobacz powyższą sekcję).
+
+Te dwie czynności **zajmują najwięcej czasu**. To główna praca związana z utrzymaniem FastAPI.
+
+Jeśli możesz mi w tym pomóc, **pomagasz mi utrzymać FastAPI** i upewnić się, że nadal **rozwija się szybciej i lepiej**. 🚀
+
+## Dołącz do czatu
+
+Dołącz do 👥 <a href="https://discord.gg/VQjSZaeJmf" class="external-link" target="_blank">serwera czatu na Discordzie</a> 👥 i spędzaj czas z innymi w społeczności FastAPI.
+
+!!! wskazówka
+    Jeśli masz pytania, zadaj je w <a href="https://github.com/tiangolo/fastapi/discussions/new?category=questions" class="external-link" target="_blank">Dyskusjach na GitHubie</a>, jest dużo większa szansa, że otrzymasz pomoc od [Ekspertów FastAPI](fastapi-people.md#experts){.internal-link target=_blank}.
+
+    Używaj czatu tylko do innych ogólnych rozmów.
+
+Istnieje również poprzedni <a href="https://gitter.im/tiangolo/fastapi" class="external-link" target="_blank">czat na Gitter</a>, ale ponieważ nie ma tam kanałów i zaawansowanych funkcji, rozmowy są trudniejsze, dlatego teraz zalecany jest Discord.
+
+### Nie zadawaj pytań na czacie
+
+Miej na uwadze, że ponieważ czaty pozwalają na bardziej "swobodną rozmowę", łatwo jest zadawać pytania, które są zbyt ogólne i trudniejsze do odpowiedzi, więc możesz nie otrzymać odpowiedzi.
+
+Na GitHubie szablon poprowadzi Cię do napisania odpowiedniego pytania, dzięki czemu łatwiej uzyskasz dobrą odpowiedź, a nawet rozwiążesz problem samodzielnie, zanim zapytasz. A na GitHubie mogę się upewnić, że zawsze odpowiadam na wszystko, nawet jeśli zajmuje to trochę czasu. Osobiście nie mogę tego zrobić z systemami czatu. 😅
+
+Rozmowy w systemach czatu nie są też tak łatwo przeszukiwalne jak na GitHubie, więc pytania i odpowiedzi mogą zaginąć w rozmowie. A tylko te na GitHubie liczą się do zostania [Ekspertem FastAPI](fastapi-people.md#experts){.internal-link target=_blank}, więc najprawdopodobniej otrzymasz więcej uwagi na GitHubie.
+
+Z drugiej strony w systemach czatu jest tysiące użytkowników, więc jest duża szansa, że znajdziesz tam kogoś do rozmowy, prawie cały czas. 😄
+
+## Wspieraj autora
+
+Możesz również finansowo wesprzeć autora (mnie) poprzez <a href="https://github.com/sponsors/tiangolo" class="external-link" target="_blank">sponsoring na GitHubie</a>.
+
+Tam możesz postawić mi kawę ☕️ aby podziękować. 😄
+
+Możesz także zostać srebrnym lub złotym sponsorem FastAPI. 🏅🎉
+
+## Wspieraj narzędzia, które napędzają FastAPI
+
+Jak widziałeś w dokumentacji, FastAPI stoi na ramionach gigantów, Starlette i Pydantic.
+
+Możesz również wesprzeć:
+
+* <a href="https://github.com/sponsors/samuelcolvin" class="external-link" target="_blank">Samuel Colvin (Pydantic)</a>
+* <a href="https://github.com/sponsors/encode" class="external-link" target="_blank">Encode (Starlette, Uvicorn)</a>
+
+---
+
+Dziękuję! 🚀