Skip to content

Commit 65a95d0

Browse files
committed
[pl] docs/contribute/advanced.md
1 parent 8a97a3c commit 65a95d0

File tree

1 file changed

+196
-0
lines changed

1 file changed

+196
-0
lines changed
Lines changed: 196 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,196 @@
1+
---
2+
title: Zaawansowana kontrybucja
3+
slug: advanced
4+
content_type: concept
5+
weight: 100
6+
---
7+
8+
<!-- overview -->
9+
10+
Ta strona zakłada, że rozumiesz, jak
11+
[tworzyć nowe treści](/docs/contribute/new-content/) i [przeglądać pracę innych](/docs/contribute/review/reviewing-prs/),
12+
i jesteś gotów nauczyć się więcej
13+
sposobów, jak wnosić wkład. Musisz umieć używać klienta wiersza
14+
poleceń Git jak rownież inne narzędzia do wykonania niektórych z tych zadań.
15+
16+
<!-- body -->
17+
18+
## Zaproponuj ulepszenia {#propose-improvements}
19+
20+
[Członkowie](/docs/contribute/participate/roles-and-responsibilities/#members)
21+
SIG Docs mogą proponować usprawnienia.
22+
23+
Po tym, jak przez jakiś czas będziesz wnosić wkład do dokumentacji Kubernetesa,
24+
możesz mieć pomysły na ulepszenie [Przewodnika Stylu](/docs/contribute/style/style-guide/),
25+
[Przewodnika Treści](/docs/contribute/style/content-guide/),
26+
narzędzi wykorzystywanych do tworzenia dokumentacji, stylu strony internetowej,
27+
procesów przeglądania i scalania pull requestów, lub innych aspektów dokumentacji. Dla
28+
maksymalnej przejrzystości, tego rodzaju propozycje muszą być omówione podczas
29+
spotkania SIG Docs lub na [liście mailingowej kubernetes-sig-docs](https://groups.google.com/forum/#!forum/kubernetes-sig-docs).
30+
Dodatkowo, może pomóc posiadanie kontekstu
31+
dotyczącego obecnego sposobu działania i przyczyn podejmowania
32+
wcześniejszych decyzji, zanim zaproponujesz radykalne zmiany. Najszybszym sposobem
33+
uzyskania odpowiedzi na pytania dotyczące obecnego działania dokumentacji jest
34+
zadanie ich na kanale `#sig-docs` na Slacku [kubernetes.slack.com](https://kubernetes.slack.com)
35+
36+
Po odbyciu dyskusji i osiągnięciu porozumienia przez SIG w sprawie
37+
pożądanego wyniku, możesz pracować nad proponowanymi zmianami w sposób
38+
najbardziej odpowiedni. Na przykład, aktualizacja wytycznych stylu lub
39+
funkcjonalności strony internetowej może wymagać otwarcia pull requesta, podczas gdy
40+
zmiana związana z testowaniem dokumentacji może wymagać współpracy z sig-testing.
41+
42+
## Koordynowanie dokumentacji do wydania Kubernetes {#coordinate-docs-for-a-kubernetes-release}
43+
44+
[Zatwierdzający](/docs/contribute/participate/roles-and-responsibilities/#approvers)
45+
SIG Docs mogą koordynować dokumentację dla wydania Kubernetesa.
46+
47+
Każde wydanie Kubernetesa jest koordynowane przez zespół osób
48+
uczestniczących w sig-release (ang. Special Interest Group - SIG).
49+
Inni członkowie zespołu wydania dla danego wydania to ogólny lider
50+
wydania, a także przedstawiciele sig-testing i innych. Aby
51+
dowiedzieć się więcej o procesach wydania Kubernetesa, odwiedź
52+
[https://github.com/kubernetes/sig-release](https://github.com/kubernetes/sig-release).
53+
54+
Przedstawiciel SIG Docs dla danego wydania koordynuje następujące zadania:
55+
56+
- Monitoruje arkusz kalkulacyjny śledzący funkcje w poszukiwaniu nowych lub
57+
zmienionych funkcji mających wpływ na dokumentację. Jeśli dokumentacja dla danej
58+
funkcji nie będzie gotowa na wydanie, funkcja może nie zostać dopuszczona do wydania.
59+
- Uczestniczy regularnie w spotkaniach sig-release i
60+
przekazuje aktualizacje dotyczące statusu dokumentacji dla wydania.
61+
- Przegląda i poprawia dokumentację funkcji
62+
napisaną przez SIG odpowiedzialny za wdrożenie tej funkcji.
63+
- Scala pull requesty związane z wydaniem i
64+
utrzymuje gałąź Git na potrzeby wydania.
65+
- Mentoruje innych współtwórców SIG Docs, którzy chcą nauczyć
66+
się, jak pełnić tę rolę w przyszłości. Jest to znane jako "shadowing".
67+
- Publikuje zmiany w dokumentacji związane z
68+
wydaniem, gdy artefakty wydania zostaną opublikowane.
69+
70+
Koordynowanie wydania to zazwyczaj zobowiązanie na 3-4 miesiące, a
71+
obowiązek ten jest rotacyjnie przejmowany przez zatwierdzających SIG Docs.
72+
73+
## Pomoganie jako Ambasador Nowego Współtwórcy {#serve-as-a-new-contributor-ambassador}
74+
75+
[Zatwierdzający](/docs/contribute/participate/roles-and-responsibilities/#approvers)
76+
SIG Docs mogą pełnić rolę Ambasadorów dla Nowych Współtwórców.
77+
78+
Ambasadorzy Nowych Współtwórców witają nowych współtwórców w
79+
SIG-Docs, proponują PR-y nowym współtwórcom i mentoruują nowych współtwórców
80+
podczas składania przez nich pierwszych kilku PR-ów.
81+
82+
Obowiązki Ambasadorów Nowych Współtwórców obejmują:
83+
84+
- Monitorowanie [kanału Slack #sig-docs](https://kubernetes.slack.com) w poszukiwaniu pytań od nowych współtwórców.
85+
- 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.
86+
- Mentoring nowych współtwórców w trakcie ich pierwszych kilku PR-ów do repozytorium dokumentacji.
87+
- Pomoc nowym współtwórcom w tworzeniu bardziej złożonych PR, które są im potrzebne, aby stać się członkami Kubernetesa.
88+
- [Sponsorowanie współtwórców](/docs/contribute/advanced/#sponsor-a-new-contributor) w ich drodze do zostania członkami Kubernetes.
89+
- Prowadzenie comiesięcznego spotkania w celu pomocy i mentorowania nowych współtwórców.
90+
91+
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).
92+
93+
## Sponsoruj nowego współtwórcę {#sponsor-a-new-contributor}
94+
95+
[Recenzenci](/docs/contribute/participate/roles-and-responsibilities/#reviewers)
96+
SIG Docs mogą sponsorować nowych współtwórców.
97+
98+
Po pomyślnym przesłaniu 5 merytorycznych pull requestów do jednego lub
99+
więcej repozytoriów Kubernetesa, nowy współtwórca może
100+
ubiegać się o [członkostwo](/docs/contribute/participate/roles-and-responsibilities/#members)
101+
w organizacji Kubernetes. Członkostwo
102+
współtwórcy musi być poparte przez dwóch sponsorów, którzy są już recenzentami.
103+
104+
Nowi współtwórcy dokumentacji mogą ubiegać się o sponsorów, pytając na
105+
kanale #sig-docs w [instancji Kubernetes na Slacku](https://kubernetes.slack.com)
106+
lub na [liście mailingowej SIG Docs](https://groups.google.com/forum/#!forum/kubernetes-sig-docs).
107+
Jeśli jesteś pewny pracy
108+
wnioskodawcy, możesz dobrowolnie go sponsorować. Gdy złożą swoje podanie o
109+
członkostwo, odpowiedz na aplikację z "+1" i dołącz szczegóły, dlaczego uważasz, że
110+
wnioskodawca jest odpowiednią osobą do członkostwa w organizacji Kubernetes.
111+
112+
## Pełnij rolę współprzewodniczącego SIG {#serve-as-a-sig-co-chair}
113+
114+
Członkowie [SIG Docs](/docs/contribute/participate/roles-and-responsibilities/#members)
115+
mogą pełnić funkcję współprzewodniczącego SIG Docs.
116+
117+
### Wymagania wstępne {#prerequisites}
118+
119+
Członek zespołu Kubernetesa musi spełniać następujące wymagania, aby zostać współprzewodniczącym:
120+
121+
- Rozumieć przepływy pracy i narzędzi SIG Docs: git, Hugo, lokalizacja, podprojekt bloga
122+
- Rozumieć, w jaki sposób inne Kubernetes SIG i repozytoria wpływają na przepływ
123+
pracy SIG Docs, w tym: [zespoły w k/org](https://github.com/kubernetes/org/blob/master/config/kubernetes/sig-docs/teams.yaml),
124+
[proces w k/community](https://github.com/kubernetes/community/tree/master/sig-docs),
125+
wtyczki w
126+
[k/test-infra](https://github.com/kubernetes/test-infra/), oraz rolę [SIG Architecture](https://github.com/kubernetes/community/tree/master/sig-architecture).
127+
Ponadto, rozumieć, jak działa
128+
[proces wydawania dokumentacji Kubernetes](/docs/contribute/advanced/#coordinate-docs-for-a-kubernetes-release).
129+
- Być zatwierdzonym przez społeczność SIG Docs bezpośrednio lub poprzez konsensus bierny.
130+
- Poświać co najmniej 5 godzin tygodniowo (a często więcej) na pełnienie roli przez minimum 6 miesięcy
131+
132+
### Odpowiedzialności {#responsibilities}
133+
134+
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.
135+
136+
Obowiązki obejmują:
137+
138+
- Koncentracja SIG Docs na maksymalizacji zadowolenia deweloperów poprzez doskonałą dokumentację
139+
- 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
140+
- Douczanie się i ustalanie najlepszych praktyk dla SIG, aktualizując wytyczne dotyczące wkładu
141+
- Planowanie i prowadzenie spotkań SIG: cotygodniowe aktualizacje statusu, kwartalne sesje retrospekcyjne/planistyczne oraz inne według potrzeby
142+
- Planowanie i realizacja sprintów dokumentacyjnych podczas wydarzeń KubeCon i innych konferencji
143+
- 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.
144+
- Utrzymywanie płynnego działania SIG
145+
146+
### Prowadzenie efektywnych spotkań {#running-effective-meetings}
147+
148+
Aby zaplanować i przeprowadzać efektywne spotkania, te wytyczne pokazują, co robić, jak to robić i dlaczego.
149+
150+
**Przestrzegaj [kodeksu postępowania społeczności](https://github.com/cncf/foundation/blob/main/code-of-conduct.md)**:
151+
152+
- Zapewnij, że dyskusje są pełne szacunku i otwartości, z użyciem odpowiedniego, włączającego języka.
153+
154+
**Ustaw klarowną agendę**:
155+
156+
- Ustal jasny harmonogram tematów
157+
- Opublikuj agendę z wyprzedzeniem
158+
159+
W przypadku cotygodniowych spotkań, skopiuj i wklej notatki z poprzedniego tygodnia do sekcji "Past meetings" w notatkach.
160+
161+
**Współpracuj nad dokładnymi notatkami**:
162+
163+
- Zapisz dyskusję z zebrania
164+
- Rozważ delegowanie roli osoby prowadzącej notatki
165+
166+
**Przypisz zadania jasno i precyzyjnie**:
167+
168+
- Zarejestruj zadanie do wykonania, osobę do niego przypisaną oraz przewidywaną datę ukończenia.
169+
170+
**Moderuj w razie potrzeby**:
171+
172+
- Jeśli dyskusja odbiega od agendy, skieruj uczestników z powrotem na bieżący temat
173+
- Zrób miejsce na różne style dyskusji, jednocześnie skupiając się na temacie rozmowy i szanując czas uczestników.
174+
175+
**Szanuj czas ludzi**:
176+
177+
Rozpoczynaj i kończ spotkania o czasie.
178+
179+
**Używaj Zoom efektywnie**:
180+
181+
- Zapoznaj się z [wytycznymi Zoom dla Kubernetes](https://github.com/kubernetes/community/blob/master/communication/zoom-guidelines.md)
182+
- Zgłoś rolę hosta po zalogowaniu się, wprowadzając klucz hosta
183+
184+
<img src="/images/docs/contribute/claim-host.png" width="75%" alt="Przejmowanie roli gospodarza w Zoom" />
185+
186+
### Nagrywanie spotkań na Zoomie {#recording-meetings-on-zoom}
187+
188+
Kiedy będziesz gotowy do rozpoczęcia nagrywania, kliknij Zapisz w chmurze.
189+
190+
Gdy będziesz gotowy, aby zatrzymać nagrywanie, kliknij Stop.
191+
192+
Film przesyła się automatycznie na YouTube.
193+
194+
### Zakończenie roli współprzewodniczącego SIG (Emeritus) {#offboarding-a-sig-co-chair-emeritus}
195+
196+
Zobacz: [k/community/sig-docs/offboarding.md](https://github.com/kubernetes/community/blob/master/sig-docs/offboarding.md)

0 commit comments

Comments
 (0)