kubernetes
/
website
mirror of https://github.com/kubernetes/website.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
website/content/pl/docs/contribute/docs.md

9.7 KiB
Raw Permalink Blame History

content_type title weight card
concept Współtworzenie dokumentacji Kubernetes 09
name weight title
contribute 11 Współtworzenie dokumentacji

Ta strona jest utrzymywana przez Kubernetes SIG Docs. Projekt Kubernetes chętnie przyjmie pomoc od wszystkich współtwórców, zarówno nowych, jak i doświadczonych!

Współtwórcy dokumentacji Kubernetesa:

  • Ulepszają istniejącą treść
  • Tworzą nowe treści
  • Tłumaczą dokumentację
  • Zarządzają i publikują części dokumentacji cyklu wydawniczego Kubernetesa

Zespół blogowy, będący częścią SIG Docs, pomaga zarządzać oficjalnymi blogami. Aby dowiedzieć się więcej, przeczytaj jak współtworzyć blogi Kubernetesa.

{{< note >}} Aby dowiedzieć się więcej o kontrybucji w Kubernetesach, zobacz ogólną dokumentację współtwórców. {{< /note >}}

Rozpoczęcie pracy

Każdy może otworzyć zgłoszenie dotyczące dokumentacji lub wnieść zmianę za pomocą pull request (PR) w repozytorium kubernetes/website na GitHubie. Musisz umieć sprawnie korzystać z git i GitHub, aby efektywnie pracować w społeczności Kubernetesa.

Aby zaangażować się w tworzenie dokumentacji:

  1. Podpisz umowę licencyjną współtwórcy CNCF.
  2. Zapoznaj się z repozytorium dokumentacji oraz generatorem statycznych stron witryny.
  3. Upewnij się, że rozumiesz podstawowe procesy otwierania pull requesta i przeglądania zmian.

{{< mermaid >}} flowchart TB subgraph third[Otwórz PR] direction TB U[ ] -.- Q[Popraw treść] --- N[Utwórz treść] N --- O[Tłumacz dokumentację] O --- P[Zarządzaj/publikuj części dokumentów
w cyklu wydania K8s]

end

subgraph second[Przegląd] direction TB T[ ] -.- D[Przejrzyj repozytorium
kubernetes/website] --- E[Sprawdź generator
stron statycznych Hugo] E --- F[Zrozum podstawowe
komendy GitHub] F --- G[Przejrzyj otwarte PR
i procesy przeglądu zmian] end

subgraph first[Rejestracja] direction TB S[ ] -.- B[Podpisz umowę o
licencję wniesienia
wkładu CNCF] --- C[Dołącz do kanału
Slack sig-docs] C --- V[Dołącz do listy
mailowej kubernetes-sig-docs] V --- M[Uczestnicz w cotygodniowych
spotkaniach sig-docs
lub spotkaniach na Slacku] end

A([fa:fa-user Nowy
Współtwórca]) --> first A --> second A --> third A --> H[Pytaj!!!]

classDef grey fill:#dddddd,stroke:#ffffff,stroke-width:px,color:#000000, font-size:15px; classDef white fill:#ffffff,stroke:#000,stroke-width:px,color:#000,font-weight:bold classDef spacewhite fill:#ffffff,stroke:#fff,stroke-width:0px,color:#000 class A,B,C,D,E,F,G,H,M,Q,N,O,P,V grey class S,T,U spacewhite class first,second,third white {{</ mermaid >}} Rysunek 1. Jak zacząć jako nowy współtwórca.

Rysunek 1 przedstawia plan działania dla nowych współtwórców. Możesz podążać za niektórymi lub wszystkimi krokami dotyczącymi Sign up i Review. Teraz możesz otwierać PR spełniające Twoje cele kontrybucji - niektóre z nich znajdziesz w sekcji Open PR. Jak zawsze, pytania są mile widziane!

Niektóre zadania wymagają większego zaufania i większego dostępu w organizacji Kubernetes. Zobacz Udział w SIG Docs po więcej szczegółów na temat ról i uprawnień.

Twoja pierwsza kontrybucja

Aby przygotować się do twojej pierwszej kontrybucji, warto wcześniej przeanalizować kilka kroków. Rysunek 2 przedstawia ich schemat, a szczegółowe informacje znajdują się poniżej.

{{< mermaid >}} flowchart LR subgraph second[Pierwszy wkład] direction TB S[ ] -.- G[Przeglądaj PR od innych
członków K8s] --> A[Sprawdź listę zgłoszeń
kubernetes/website
dobre na pierwszy PR] --> B[Otwórz PR!!] end subgraph first[Zalecane przygotowanie] direction TB T[ ] -.- D[Przeczytaj współtworzenie nowych treści] -->E[Przeczytaj przewodniki
po treści K8s i stylach] E --> F[Poznaj typy treści
stron Hugo
i shortcode'y] end

first ----> second

classDef grey fill:#dddddd,stroke:#ffffff,stroke-width:px,color:#000000, font-size:15px; classDef white fill:#ffffff,stroke:#000,stroke-width:px,color:#000,font-weight:bold classDef spacewhite fill:#ffffff,stroke:#fff,stroke-width:0px,color:#000 class A,B,D,E,F,G grey class S,T spacewhite class first,second white {{</ mermaid >}} Rysunek 2. Przygotowanie do twojej pierwszej kontrybucji.

Uzyskiwanie pomocy przy współtworzeniu

Rozpoczęcie współpracy nad projektem może być wyzwaniem. Ambasadorzy Nowych Współtwórców pomogą Ci przejść przez pierwsze kroki. Możesz skontaktować się z nimi na Kubernetes Slack, najlepiej na kanale #sig-docs. Istnieje również rozmowa powitalna dla nowych współtwórców, która odbywa się w pierwszy wtorek każdego miesiąca. Możesz tu wchodzić w interakcje z Ambasadorami Nowych Współtwórców i uzyskać odpowiedzi na swoje pytania.

Następne kroki.

Zaangażuj się w SIG Docs.

SIG Docs to grupa współtwórców, którzy publikują i utrzymują dokumentację Kubernetesa oraz stronę internetową. Zaangażowanie się w SIG Docs to doskonały sposób dla współtwórców Kubernetes (rozwój funkcji lub inne) na wywarcie dużego wpływu na projekt Kubernetesa.

SIG Dokumentacja komunikuje się za pomocą różnych metod:

Inne sposoby wnoszenia wkładu