Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[pl] docs/contribute/advanced.md #49639

Open
wants to merge 2 commits into
base: main
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
196 changes: 196 additions & 0 deletions content/pl/docs/contribute/advanced.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,196 @@
---
title: Zaawansowana kontrybucja
slug: advanced
content_type: concept
weight: 100
---

<!-- overview -->

Ta strona zakłada, że rozumiesz, jak
[tworzyć nowe treści](/docs/contribute/new-content/) i [przeglądać pracę innych](/docs/contribute/review/reviewing-prs/),
i jesteś gotów nauczyć się więcej
sposobów, jak wnosić wkład. Musisz umieć używać klienta wiersza
poleceń Git jak rownież inne narzędzia do wykonania niektórych z tych zadań.

<!-- body -->

## Zaproponuj ulepszenia {#propose-improvements}

[Członkowie](/docs/contribute/participate/roles-and-responsibilities/#members)
SIG Docs mogą proponować usprawnienia.

Po tym, jak przez jakiś czas będziesz wnosić wkład do dokumentacji Kubernetesa,
możesz mieć pomysły na ulepszenie [Przewodnika Stylu](/docs/contribute/style/style-guide/),
[Przewodnika Treści](/docs/contribute/style/content-guide/),
narzędzi wykorzystywanych do tworzenia dokumentacji, stylu strony internetowej,
procesów przeglądania i scalania pull requestów, lub innych aspektów dokumentacji. Dla
maksymalnej przejrzystości, tego rodzaju propozycje muszą być omówione podczas
spotkania SIG Docs lub na [liście mailingowej kubernetes-sig-docs](https://groups.google.com/forum/#!forum/kubernetes-sig-docs).
Dodatkowo, może pomóc posiadanie kontekstu
dotyczącego obecnego sposobu działania i przyczyn podejmowania
wcześniejszych decyzji, zanim zaproponujesz radykalne zmiany. Najszybszym sposobem
uzyskania odpowiedzi na pytania dotyczące obecnego działania dokumentacji jest
zadanie ich na kanale `#sig-docs` na Slacku [kubernetes.slack.com](https://kubernetes.slack.com)

Po odbyciu dyskusji i osiągnięciu porozumienia przez SIG w sprawie
pożądanego wyniku, możesz pracować nad proponowanymi zmianami w sposób
najbardziej odpowiedni. Na przykład, aktualizacja wytycznych stylu lub
funkcjonalności strony internetowej może wymagać otwarcia pull requesta, podczas gdy
zmiana związana z testowaniem dokumentacji może wymagać współpracy z sig-testing.

## Koordynowanie dokumentacji do wydania Kubernetes {#coordinate-docs-for-a-kubernetes-release}

[Zatwierdzający](/docs/contribute/participate/roles-and-responsibilities/#approvers)
SIG Docs mogą koordynować dokumentację dla wydania Kubernetesa.

Każde wydanie Kubernetesa jest koordynowane przez zespół osób
uczestniczących w sig-release (ang. Special Interest Group - SIG).
Inni członkowie zespołu wydania dla danego wydania to ogólny lider
wydania, a także przedstawiciele sig-testing i innych. Aby
dowiedzieć się więcej o procesach wydania Kubernetesa, odwiedź
[https://github.com/kubernetes/sig-release](https://github.com/kubernetes/sig-release).

Przedstawiciel SIG Docs dla danego wydania koordynuje następujące zadania:

- Monitoruje arkusz kalkulacyjny śledzący funkcje w poszukiwaniu nowych lub
zmienionych funkcji mających wpływ na dokumentację. Jeśli dokumentacja dla danej
funkcji nie będzie gotowa na wydanie, funkcja może nie zostać dopuszczona do wydania.
- Uczestniczy regularnie w spotkaniach sig-release i
przekazuje aktualizacje dotyczące statusu dokumentacji dla wydania.
- Przegląda i poprawia dokumentację funkcji
napisaną przez SIG odpowiedzialny za wdrożenie tej funkcji.
- Scala pull requesty związane z wydaniem i
utrzymuje gałąź Git na potrzeby wydania.
- Mentoruje innych współtwórców SIG Docs, którzy chcą nauczyć
się, jak pełnić tę rolę w przyszłości. Jest to znane jako "shadowing".
- Publikuje zmiany w dokumentacji związane z
wydaniem, gdy artefakty wydania zostaną opublikowane.

Koordynowanie wydania to zazwyczaj zobowiązanie na 3-4 miesiące, a
obowiązek ten jest rotacyjnie przejmowany przez zatwierdzających SIG Docs.

## Pomoganie jako Ambasador Nowego Współtwórcy {#serve-as-a-new-contributor-ambassador}

[Zatwierdzający](/docs/contribute/participate/roles-and-responsibilities/#approvers)
SIG Docs mogą pełnić rolę Ambasadorów dla Nowych Współtwórców.

Ambasadorzy Nowych Współtwórców witają nowych współtwórców w
SIG-Docs, proponują PR-y nowym współtwórcom i mentoruują nowych współtwórców
podczas składania przez nich pierwszych kilku PR-ów.

Obowiązki Ambasadorów Nowych Współtwórców obejmują:

- Monitorowanie [kanału Slack #sig-docs](https://kubernetes.slack.com) w poszukiwaniu pytań od nowych współtwórców.
- Współprace z osobami zajmującymi się obsługą PR w celu zidentyfikowania [dobrych pierwszych problemów](https://kubernetes.dev/docs/guide/help-wanted/#good-first-issue) dla nowych współtwórców.
- Mentoring nowych współtwórców w trakcie ich pierwszych kilku PR-ów do repozytorium dokumentacji.
- Pomoc nowym współtwórcom w tworzeniu bardziej złożonych PR, które są im potrzebne, aby stać się członkami Kubernetesa.
- [Sponsorowanie współtwórców](/docs/contribute/advanced/#sponsor-a-new-contributor) w ich drodze do zostania członkami Kubernetes.
- Prowadzenie comiesięcznego spotkania w celu pomocy i mentorowania nowych współtwórców.

Obecni Ambasadorzy Nowych Współtwórców są ogłaszani na każdym spotkaniu SIG-Docs oraz w [kanale Kubernetes #sig-docs](https://kubernetes.slack.com).

## Sponsoruj nowego współtwórcę {#sponsor-a-new-contributor}

[Recenzenci](/docs/contribute/participate/roles-and-responsibilities/#reviewers)
SIG Docs mogą sponsorować nowych współtwórców.

Po pomyślnym przesłaniu 5 merytorycznych pull requestów do jednego lub
więcej repozytoriów Kubernetesa, nowy współtwórca może
ubiegać się o [członkostwo](/docs/contribute/participate/roles-and-responsibilities/#members)
w organizacji Kubernetes. Członkostwo
współtwórcy musi być poparte przez dwóch sponsorów, którzy są już recenzentami.

Nowi współtwórcy dokumentacji mogą ubiegać się o sponsorów, pytając na
kanale #sig-docs w [instancji Kubernetes na Slacku](https://kubernetes.slack.com)
lub na [liście mailingowej SIG Docs](https://groups.google.com/forum/#!forum/kubernetes-sig-docs).
Jeśli jesteś pewny pracy
wnioskodawcy, możesz dobrowolnie go sponsorować. Gdy złożą swoje podanie o
członkostwo, odpowiedz na aplikację z "+1" i dołącz szczegóły, dlaczego uważasz, że
wnioskodawca jest odpowiednią osobą do członkostwa w organizacji Kubernetes.

## Pełnij rolę współprzewodniczącego SIG {#serve-as-a-sig-co-chair}

Członkowie [SIG Docs](/docs/contribute/participate/roles-and-responsibilities/#members)
mogą pełnić funkcję współprzewodniczącego SIG Docs.

### Wymagania wstępne {#prerequisites}

Członek zespołu Kubernetesa musi spełniać następujące wymagania, aby zostać współprzewodniczącym:

- Rozumieć przepływy pracy i narzędzi SIG Docs: git, Hugo, lokalizacja, podprojekt bloga
- Rozumieć, w jaki sposób inne Kubernetes SIG i repozytoria wpływają na przepływ
pracy SIG Docs, w tym: [zespoły w k/org](https://github.com/kubernetes/org/blob/master/config/kubernetes/sig-docs/teams.yaml),
[proces w k/community](https://github.com/kubernetes/community/tree/master/sig-docs),
wtyczki w
[k/test-infra](https://github.com/kubernetes/test-infra/), oraz rolę [SIG Architecture](https://github.com/kubernetes/community/tree/master/sig-architecture).
Ponadto, rozumieć, jak działa
[proces wydawania dokumentacji Kubernetes](/docs/contribute/advanced/#coordinate-docs-for-a-kubernetes-release).
- Być zatwierdzonym przez społeczność SIG Docs bezpośrednio lub poprzez konsensus bierny.
- Poświać co najmniej 5 godzin tygodniowo (a często więcej) na pełnienie roli przez minimum 6 miesięcy

### Odpowiedzialności {#responsibilities}

Rola współprzewodniczącego jest rolą usługową: współprzewodniczący buduje potencjał współpracowników, zajmuje się procesami i polityką, organizuje i prowadzi spotkania, planuje "PR wranglers", promuje dokumentację w społeczności Kubernetesa, dba o to, aby dokumentacja odnosiła sukcesy w cyklach wydawniczych Kubernetes oraz utrzymuje SIG Docs skupione na efektywnych priorytetach.

Obowiązki obejmują:

- Koncentracja SIG Docs na maksymalizacji zadowolenia deweloperów poprzez doskonałą dokumentację
- Bycie przykładem w przestrzeganiu [kodeksu postępowania społeczności](https://github.com/cncf/foundation/blob/main/code-of-conduct.md) i pociąganie członków SIG do odpowiedzialności za jego przestrzeganie
- Douczanie się i ustalanie najlepszych praktyk dla SIG, aktualizując wytyczne dotyczące wkładu
- Planowanie i prowadzenie spotkań SIG: cotygodniowe aktualizacje statusu, kwartalne sesje retrospekcyjne/planistyczne oraz inne według potrzeby
- Planowanie i realizacja sprintów dokumentacyjnych podczas wydarzeń KubeCon i innych konferencji
- Rekrutowanie i działanie jako rzecznik SIG Docs w imieniu {{< glossary_tooltip text="CNCF" term_id="cncf" >}} i jego platynowych partnerów, w tym Google, Oracle, Azure, IBM i Huawei.
- Utrzymywanie płynnego działania SIG

### Prowadzenie efektywnych spotkań {#running-effective-meetings}

Aby zaplanować i przeprowadzać efektywne spotkania, te wytyczne pokazują, co robić, jak to robić i dlaczego.

**Przestrzegaj [kodeksu postępowania społeczności](https://github.com/cncf/foundation/blob/main/code-of-conduct.md)**:

- Zapewnij, że dyskusje są pełne szacunku i otwartości, z użyciem odpowiedniego, włączającego języka.

**Ustaw klarowną agendę**:

- Ustal jasny harmonogram tematów
- Opublikuj agendę z wyprzedzeniem

W przypadku cotygodniowych spotkań, skopiuj i wklej notatki z poprzedniego tygodnia do sekcji "Past meetings" w notatkach.

**Współpracuj nad dokładnymi notatkami**:

- Zapisz dyskusję z zebrania
- Rozważ delegowanie roli osoby prowadzącej notatki

**Przypisz zadania jasno i precyzyjnie**:

- Zarejestruj zadanie do wykonania, osobę do niego przypisaną oraz przewidywaną datę ukończenia.

**Moderuj w razie potrzeby**:

- Jeśli dyskusja odbiega od agendy, skieruj uczestników z powrotem na bieżący temat
- Zrób miejsce na różne style dyskusji, jednocześnie skupiając się na temacie rozmowy i szanując czas uczestników.

**Szanuj czas ludzi**:

Rozpoczynaj i kończ spotkania o czasie.

**Używaj Zoom efektywnie**:

- Zapoznaj się z [wytycznymi Zoom dla Kubernetes](https://github.com/kubernetes/community/blob/master/communication/zoom-guidelines.md)
- Zgłoś rolę hosta po zalogowaniu się, wprowadzając klucz hosta

<img src="/images/docs/contribute/claim-host.png" width="75%" alt="Przejmowanie roli gospodarza w Zoom" />

### Nagrywanie spotkań na Zoomie {#recording-meetings-on-zoom}

Kiedy będziesz gotowy do rozpoczęcia nagrywania, kliknij Zapisz w chmurze.

Gdy będziesz gotowy, aby zatrzymać nagrywanie, kliknij Stop.

Film przesyła się automatycznie na YouTube.

### Zakończenie roli współprzewodniczącego SIG (Emeritus) {#offboarding-a-sig-co-chair-emeritus}

Zobacz: [k/community/sig-docs/offboarding.md](https://github.com/kubernetes/community/blob/master/sig-docs/offboarding.md)