|
1 | 1 | ---
|
2 | 2 | content_template: templates/concept
|
3 |
| -title: Weź udział w tworzeniu dokumentacji Kubernetesa |
| 3 | +title: Współtwórz dokumentację Kubernetesa |
4 | 4 | linktitle: Weź udział
|
5 | 5 | main_menu: true
|
6 | 6 | weight: 80
|
| 7 | +card: |
| 8 | + name: contribute |
| 9 | + weight: 10 |
| 10 | + title: Weź udział |
7 | 11 | ---
|
8 | 12 |
|
9 | 13 | {{% capture overview %}}
|
10 | 14 |
|
11 |
| -Będzie nam bardzo miło, jeśli zechcesz wziąć udział w tworzeniu dokumentacji |
12 |
| -lub strony www Kubernetesa! Nieważne, czy dopiero poznajesz projekt, czy jesteś |
13 |
| -z nami już od dawna, czy uważasz się za programistę, użytkownika, czy po prostu |
14 |
| -nie możesz patrzeć na literówki. |
| 15 | +Tym serwisem www opiekuje się [Kubernetes SIG Docs](/docs/contribute/#get-involved-with-sig-docs). |
| 16 | + |
| 17 | +Współtwórcy dokumentacji Kubernetesa: |
| 18 | + |
| 19 | +- Ulepszają istniejącą zawartość |
| 20 | +- Tworzą nowe treści |
| 21 | +- Tłumaczą dokumentację |
| 22 | +- Zarządzają i publikują dokumentację w ramach cyklu wydawniczego Kubernetesa |
| 23 | + |
| 24 | +Zapraszamy do współpracy wszystkich - zarówno nowicjuszy, jak i doświadczonych! |
15 | 25 |
|
16 | 26 | {{% /capture %}}
|
17 | 27 |
|
18 | 28 | {{% capture body %}}
|
19 | 29 |
|
20 |
| -## Od czego zacząć? |
| 30 | +## Jak zacząć? |
21 | 31 |
|
22 |
| -Każdy może otworzyć zgłoszenie, które zawiera opis problemu czy oczekiwane usprawnienia dokumentacji lub samemu zaproponować zmianę poprzez *pull request* (PR). |
23 |
| -Do realizacji niektórych zadań potrzeba wyższego poziomu zaufania i odpowiednich uprawnień w organizacji Kubernetes. |
24 |
| -Zajrzyj do [Participating in SIG Docs](/docs/contribute/participating/) po więcej szczegółów |
25 |
| -dotyczących ról i uprawnień. |
26 |
| - |
27 |
| -Dokumentacja Kubernetesa znajduje się w repozytorium GitHub. Zapraszamy wszystkich |
28 |
| -do aktywnych działań na rzecz jej rozwoju, niemniej aby móc sprawnie funkcjonować w społeczności Kubernetes, |
29 |
| -wymagana jest pewna biegłość w korzystaniu z git i GitHuba. |
| 32 | +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, |
| 33 | +wymagana jest pewna biegłość w korzystaniu z [git-a](https://git-scm.com/) i [GitHub-a](https://lab.github.com/). |
30 | 34 |
|
31 | 35 | Aby zaangażować się w prace nad dokumentacją należy:
|
32 | 36 |
|
33 | 37 | 1. Podpisać [Contributor License Agreement](https://github.com/kubernetes/community/blob/master/CLA.md) CNCF.
|
34 | 38 | 2. Zapoznać się z [repozytorium dokumentacji](https://github.com/kubernetes/website) i z [generatorem statycznej strony](https://gohugo.io) www.
|
35 |
| -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). |
| 39 | +3. Zrozumieć podstawowe procesy [otwierania *pull request*](/docs/contribute/new-content/new-content/) oraz [recenzowania zmian](/docs/contribute/review/reviewing-prs/). |
| 40 | + |
| 41 | +Do realizacji niektórych zadań potrzeba wyższego poziomu zaufania i odpowiednich uprawnień w organizacji Kubernetes. |
| 42 | +Zajrzyj do [Participating in SIG Docs](/docs/contribute/participating/) po więcej szczegółów dotyczących |
| 43 | +ról i uprawnień. |
| 44 | + |
| 45 | +## Pierwsze kroki |
| 46 | + |
| 47 | +- Przeczytaj [Contribution overview](/docs/contribute/new-content/overview/), aby dowiedzieć się o różnych sposobach współpracy. |
| 48 | +- Zajrzyj do [Contribute to kubernetes/website](https://github.com/kubernetes/website/contribute) aby znaleźć dobre zgłoszenie na początek. |
| 49 | +- [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. |
| 50 | +- [Zrecenzuj *pull requests*](/docs/contribute/review/reviewing-prs/) innego członka społeczności Kubernetes pod kątem dokładności i stylu. |
| 51 | +- 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. |
| 52 | +- 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. |
| 53 | + |
| 54 | +## Co dalej? |
| 55 | + |
| 56 | +- Naucz się, jak [pracować z lokalną kopią](/docs/contribute/new-content/new-content/#fork-the-repo) repozytorium. |
| 57 | +- Udokumentuj [nowe funkcjonalności](/docs/contribute/new-content/new-features/). |
| 58 | +- Włącz się w prace [SIG Docs](/docs/contribute/participating/) i zostań [członkiem organizacji lub recenzentem](/docs/contribute/participating/#roles-and-responsibilities). |
| 59 | +- Pomagaj przy [tłumaczeniu](/docs/contribute/localization/). |
| 60 | + |
| 61 | +## Włącz się w prace SIG Docs |
36 | 62 |
|
37 |
| -## Najlepsze praktyki zgłaszania zmian |
| 63 | +[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. |
38 | 64 |
|
39 |
| -- Opis GIT commit powinien być jasny i zrozumiały. |
40 |
| -- Należy używać _Github Special Keywords_, które odwołują się do zgłoszenia _(issue)_ i automatycznie je zamykają, kiedy PR zostaje zaakceptowany. |
41 |
| -- 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. |
42 |
| -- 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. |
43 |
| -- Dodatkowa literatura: |
44 |
| - - [chris.beams.io/posts/git-commit/](https://chris.beams.io/posts/git-commit/) |
45 |
| - - [github.com/blog/1506-closing-issues-via-pull-requests ](https://github.com/blog/1506-closing-issues-via-pull-requests) |
46 |
| - - [davidwalsh.name/squash-commits-git ](https://davidwalsh.name/squash-commits-git ) |
| 65 | +Aby włączyć się w komunikację w ramach SIG Docs, możesz: |
47 | 66 |
|
| 67 | +- [Dołączyć do kanału `#sig-docs` na komunikatorze Slack dla Kubernetesa](http://slack.k8s.io/). Nie zapomnij |
| 68 | + się przedstawić! |
| 69 | +- [Zapisać się na listę `kubernetes-sig-docs`](https://groups.google.com/forum/#!forum/kubernetes-sig-docs), |
| 70 | + na której prowadzone są dyskusje o szerszym zasięgu i zapisywane oficjalne decyzje. |
| 71 | +- 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ć. |
48 | 72 |
|
49 |
| -## Inne metody współpracy |
| 73 | +## Inne sposoby współpracy |
50 | 74 |
|
51 |
| -- 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/). |
52 |
| -- 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). |
| 75 | +- 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. |
| 76 | +- 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. |
| 77 | +- Przygotuj [wpis na blogu lub *case study*](/docs/contribute/new-content/blogs-case-studies/). |
53 | 78 |
|
54 | 79 | {{% /capture %}}
|
0 commit comments