---
content_template: templates/concept
title: Weź udział w tworzeniu dokumentacji Kubernetesa
linktitle: Weź udział
main_menu: true
weight: 80
---

{{% 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.

{{% /capture %}}

{{% capture body %}}

## Od czego 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.

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).

## Najlepsze praktyki zgłaszania zmian

- 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 )


## Inne metody współpracy

- 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).

{{% /capture %}}