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