Update Polish translation of Contribute index page
This commit is contained in:
Maciej Filocha
@@ -1,54 +1,79 @@
|
||||
---
|
||||
content_template: templates/concept
|
||||
title: Weź udział w tworzeniu dokumentacji Kubernetesa
|
||||
title: Współtwórz dokumentację Kubernetesa
|
||||
linktitle: Weź udział
|
||||
main_menu: true
|
||||
weight: 80
|
||||
card:
|
||||
name: contribute
|
||||
weight: 10
|
||||
title: Weź udział
|
||||
---
|
||||
|
||||
{{% capture overview %}}
|
||||
|
||||
Będzie nam bardzo miło, jeśli zechcesz wziąć udział w tworzeniu dokumentacji
|
||||
lub strony www Kubernetesa! Nieważne, czy dopiero poznajesz projekt, czy jesteś
|
||||
z nami już od dawna, czy uważasz się za programistę, użytkownika, czy po prostu
|
||||
nie możesz patrzeć na literówki.
|
||||
Tym serwisem www opiekuje się [Kubernetes SIG Docs](/docs/contribute/#get-involved-with-sig-docs).
|
||||
|
||||
Współtwórcy dokumentacji Kubernetesa:
|
||||
|
||||
- Ulepszają istniejącą zawartość
|
||||
- Tworzą nowe treści
|
||||
- Tłumaczą dokumentację
|
||||
- Zarządzają i publikują dokumentację w ramach cyklu wydawniczego Kubernetesa
|
||||
|
||||
Zapraszamy do współpracy wszystkich - zarówno nowicjuszy, jak i doświadczonych!
|
||||
|
||||
{{% /capture %}}
|
||||
|
||||
{{% capture body %}}
|
||||
|
||||
## Od czego zacząć?
|
||||
## Jak zacząć?
|
||||
|
||||
Każdy może otworzyć zgłoszenie, które zawiera opis problemu czy oczekiwane usprawnienia dokumentacji lub samemu zaproponować zmianę poprzez *pull request* (PR).
|
||||
Do realizacji niektórych zadań potrzeba wyższego poziomu zaufania i odpowiednich uprawnień w organizacji Kubernetes.
|
||||
Zajrzyj do [Participating in SIG Docs](/docs/contribute/participating/) po więcej szczegółów
|
||||
dotyczących ról i uprawnień.
|
||||
|
||||
Dokumentacja Kubernetesa znajduje się w repozytorium GitHub. Zapraszamy wszystkich
|
||||
do aktywnych działań na rzecz jej rozwoju, niemniej aby móc sprawnie funkcjonować w społeczności Kubernetes,
|
||||
wymagana jest pewna biegłość w korzystaniu z git i GitHuba.
|
||||
Każdy może otworzyć zgłoszenie dotyczące dokumentacji lub zaproponować zmianę poprzez *pull request* (PR) do [repozytorium GitHub `kubernetes/website`](https://github.com/kubernetes/website). Aby móc sprawnie funkcjonować w społeczności Kubernetes,
|
||||
wymagana jest pewna biegłość w korzystaniu z [git-a](https://git-scm.com/) i [GitHub-a](https://lab.github.com/).
|
||||
|
||||
Aby zaangażować się w prace nad dokumentacją należy:
|
||||
|
||||
1. Podpisać [Contributor License Agreement](https://github.com/kubernetes/community/blob/master/CLA.md) CNCF.
|
||||
2. Zapoznać się z [repozytorium dokumentacji](https://github.com/kubernetes/website) i z [generatorem statycznej strony](https://gohugo.io) www.
|
||||
3. Zrozumieć podstawowe procesy [ulepszania zawartości](https://kubernetes.io/docs/contribute/start/#improve-existing-content) i [recenzowania propozycji zmian](https://kubernetes.io/docs/contribute/start/#review-docs-pull-requests).
|
||||
3. Zrozumieć podstawowe procesy [otwierania *pull request*](/docs/contribute/new-content/new-content/) oraz [recenzowania zmian](/docs/contribute/review/reviewing-prs/).
|
||||
|
||||
## Najlepsze praktyki zgłaszania zmian
|
||||
Do realizacji niektórych zadań potrzeba wyższego poziomu zaufania i odpowiednich uprawnień w organizacji Kubernetes.
|
||||
Zajrzyj do [Participating in SIG Docs](/docs/contribute/participating/) po więcej szczegółów dotyczących
|
||||
ról i uprawnień.
|
||||
|
||||
- Opis GIT commit powinien być jasny i zrozumiały.
|
||||
- Należy używać _Github Special Keywords_, które odwołują się do zgłoszenia _(issue)_ i automatycznie je zamykają, kiedy PR zostaje zaakceptowany.
|
||||
- Kiedy wprowadzasz drobne zmiany do PR, takie jak literówki czy poprawki stylu lub gramatyki, pamiętaj o ich zgrupowaniu _(squash)_, aby uniknąć sytuacji, kiedy mamy dużą liczbę commitów dla stosunkowo niewielkiej zmiany.
|
||||
- Dołącz dobry opis PR, który tłumaczy zmiany w kodzie, powód dla tych zmian i wszystkie informacje wystarczające, aby recenzent zrozumiał Twój PR.
|
||||
- Dodatkowa literatura:
|
||||
- [chris.beams.io/posts/git-commit/](https://chris.beams.io/posts/git-commit/)
|
||||
- [github.com/blog/1506-closing-issues-via-pull-requests ](https://github.com/blog/1506-closing-issues-via-pull-requests)
|
||||
- [davidwalsh.name/squash-commits-git ](https://davidwalsh.name/squash-commits-git )
|
||||
## Pierwsze kroki
|
||||
|
||||
- Przeczytaj [Contribution overview](/docs/contribute/new-content/overview/), aby dowiedzieć się o różnych sposobach współpracy.
|
||||
- Zajrzyj do [Contribute to kubernetes/website](https://github.com/kubernetes/website/contribute) aby znaleźć dobre zgłoszenie na początek.
|
||||
- [Otwórz *pull request* przy pomocy GitHub-a](/docs/contribute/new-content/new-content/#changes-using-github) dotyczący zmiany istniejącej dokumentacji i dowiedz się, jak otwierać zgłoszenia przy GitHub-ie.
|
||||
- [Zrecenzuj *pull requests*](/docs/contribute/review/reviewing-prs/) innego członka społeczności Kubernetes pod kątem dokładności i stylu.
|
||||
- Zapoznaj się z poradnikami Kubernetesa dotyczącymi [zawartości](/docs/contribute/style/content-guide/) i [stylu](/docs/contribute/style/style-guide/), aby twoje uwagi były zgodne z tymi wytycznymi.
|
||||
- Dowiedz się, jak [używać szablonów stron](/docs/contribute/style/page-templates/) i [skrótów Hugo](/docs/contribute/style/hugo-shortcodes/), aby wprowadzać większe zmiany.
|
||||
|
||||
## Inne metody współpracy
|
||||
## Co dalej?
|
||||
|
||||
- Aby włączyć się w prace społeczności Kubernetes poprzez fora internetowe, typu Twitter czy Stack Overflow, lub dowiedzieć się więcej na temat organizowanych lokalnie spotkań i wydarzeń związanym z projektem, zajrzyj na stronę [społeczności Kubernetes](/community/).
|
||||
- Aby włączyć się w prace związane z nowymi funkcjonalnościami, przeczytaj na początek [ściągawkę dla współautorów](https://github.com/kubernetes/community/tree/master/contributors/guide/contributor-cheatsheet).
|
||||
- Naucz się, jak [pracować z lokalną kopią](/docs/contribute/new-content/new-content/#fork-the-repo) repozytorium.
|
||||
- Udokumentuj [nowe funkcjonalności](/docs/contribute/new-content/new-features/).
|
||||
- Włącz się w prace [SIG Docs](/docs/contribute/participating/) i zostań [członkiem organizacji lub recenzentem](/docs/contribute/participating/#roles-and-responsibilities).
|
||||
- Pomagaj przy [tłumaczeniu](/docs/contribute/localization/).
|
||||
|
||||
## Włącz się w prace SIG Docs
|
||||
|
||||
[SIG Docs](/docs/contribute/participating/) to grupa, która publikuje i utrzymuje dokumentację Kubernetesa i jej stronę www. Zaangażowanie się w prace SIG Docs to doskonała okazja dla współtwórców Kubernetesa (rozwijających nowe funkcjonalności lub działających w innych obszarach), aby wywierać wpływ na cały projekt Kubernetes.
|
||||
|
||||
Aby włączyć się w komunikację w ramach SIG Docs, możesz:
|
||||
|
||||
- [Dołączyć do kanału `#sig-docs` na komunikatorze Slack dla Kubernetesa](http://slack.k8s.io/). Nie zapomnij
|
||||
się przedstawić!
|
||||
- [Zapisać się na listę `kubernetes-sig-docs`](https://groups.google.com/forum/#!forum/kubernetes-sig-docs),
|
||||
na której prowadzone są dyskusje o szerszym zasięgu i zapisywane oficjalne decyzje.
|
||||
- Dołączyć do [cotygodniowego spotkania wideo SIG Docs](https://github.com/kubernetes/community/tree/master/sig-docs). Spotkania są zawsze zapowiadane na `#sig-docs` i dodawane do [kalendarza spotkań społeczności Kubernetes](https://calendar.google.com/calendar/embed?src=cgnt364vd8s86hr2phapfjc6uk%40group.calendar.google.com&ctz=America/Los_Angeles). Będziesz potrzebował komunikatora [Zoom](https://zoom.us/download) lub telefonu, aby się wdzwonić.
|
||||
|
||||
## Inne sposoby współpracy
|
||||
|
||||
- Odwiedź [stronę społeczności Kubernetes](/community/). Korzystaj z Twittera i Stack Overflow, dowiedz się o spotkaniach lokalnych grup Kubernetes, różnych wydarzeniach i nie tylko.
|
||||
- Przeczytaj [ściągawkę dla współtwórców](https://github.com/kubernetes/community/tree/master/contributors/guide/contributor-cheatsheet), aby zaangażować się w dalszy rozwój Kubernetesa.
|
||||
- Przygotuj [wpis na blogu lub *case study*](/docs/contribute/new-content/blogs-case-studies/).
|
||||
|
||||
{{% /capture %}}
|
||||
|
||||
Reference in New Issue
Block a user