Maciej Filocha
3b241356e5
Update translated content to uptream master version as for March 15th. Commits from90ee7559a0tod4167faa2c.
55 lines
3.2 KiB
Markdown
55 lines
3.2 KiB
Markdown
---
|
|
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 %}}
|