Skip to content

Commit 9c61e8a

Browse files
authored
Merge pull request #49707 from dkarczmarski/dkarczmarski/pl-docs-contribute-suggesting-improvements.md
[pl] docs/contribute/suggesting-improvements.md
2 parents 527dcc3 + e6ae43e commit 9c61e8a

File tree

1 file changed

+67
-0
lines changed

1 file changed

+67
-0
lines changed
Lines changed: 67 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,67 @@
1+
---
2+
title: Zgłaszanie propozycji poprawy treści
3+
content_type: concept
4+
weight: 10
5+
card:
6+
name: contribute
7+
weight: 15
8+
anchors:
9+
- anchor: "#opening-an-issue"
10+
title: Zgłoś propozycję poprawy treści
11+
---
12+
13+
<!-- overview -->
14+
15+
Jeśli zauważysz problem z dokumentacją Kubernetesa lub masz pomysł na nową treść, otwórz zgłoszenie. Wszystko, czego potrzebujesz, to [konto GitHub](https://github.com/join) i przeglądarka internetowa.
16+
17+
W większości przypadków nowa praca nad dokumentacją Kubernetesa rozpoczyna się od zgłoszenia na
18+
GitHubie. Współtwórcy Kubernetesa następnie przeglądają, kategoryzują i tagują zgłoszenia. Następnie
19+
Ty lub inny członek społeczności Kubernetesa otwiera pull requesta z poprawkami rozwiązującymi problem.
20+
21+
22+
23+
<!-- body -->
24+
25+
## Otwarcie zgłoszenia {#opening-an-issue}
26+
27+
Jeśli chcesz zasugerować ulepszenia do istniejącej treści lub zauważysz błąd, otwórz zgłoszenie.
28+
29+
1. Kliknij link **Create an issue** na prawym pasku bocznym. Przekieruje
30+
Cię to na stronę z problemem w GitHub wstępnie wypełnioną kilkoma nagłówkami.
31+
2. Opisz problem lub sugestię poprawy. Podaj jak najwięcej szczegółów.
32+
3. Kliknij **Submit new issue**.
33+
34+
Po przesłaniu, od czasu do czasu sprawdzaj swoje zgłoszenie lub włącz
35+
powiadomienia GitHub. Recenzenci i inni członkowie społeczności mogą
36+
zadawać pytania, zanim będą mogli podjąć działania w sprawie Twojego zgłoszenia.
37+
38+
## Sugestia nowej treści {#suggesting-new-content}
39+
40+
Jeśli masz pomysł na nowe treści, ale nie jesteś pewien, gdzie powinny
41+
się one znaleźć, możesz nadal utworzyć zgłoszenie. Wykonaj jeden z kroków:
42+
43+
- Wybierz istniejącą stronę w sekcji, do której Twoim zdaniem należy treść, i kliknij **Create an issue**.
44+
- Przejdź do [GitHub](https://github.com/kubernetes/website/issues/new/) i utwórz zgłoszenie bezpośrednio.
45+
46+
## Jak tworzyć świetne zgłoszenia {#how-to-file-great-issues}
47+
48+
49+
Pamiętaj o następujących rzeczach przy zgłaszaniu problemu:
50+
51+
- Podaj jasny opis problemu. Opisz, co konkretnie
52+
jest brakujące, nieaktualne, błędne lub wymaga poprawy.
53+
- Wyjaśnij, jaki konkretny wpływ ma ten problem na użytkowników.
54+
- W przypadku problemów o dużym zakresie, podziel je na mniejsze zagadnienia, aby
55+
łatwiej było nad nimi pracować. Na przykład, "Napraw dokumentację
56+
dotyczącą bezpieczeństwa" jest zbyt ogólne, ale "Dodaj szczegóły do tematu
57+
'Ograniczanie dostępu do sieci'" jest na tyle precyzyjne, by można było podjąć działanie.
58+
- Przeszukaj istniejące zgłoszenia, aby sprawdzić, czy jest
59+
coś związanego lub podobnego do nowego zgłoszenia.
60+
- Jeśli nowe zgłoszenie dotyczy innego zgłoszenia lub pull requesta,
61+
odwołaj się do niego poprzez podanie pełnego adresu URL lub numeru zgłoszenia lub pull
62+
requesta poprzedzonego znakiem `#`. Na przykład: `Introduced by #987654`.
63+
- Przestrzegaj [Kodeksu postępowania](/community/code-of-conduct/).
64+
Szanuj innych współtwórców. Na przykład,
65+
"Dokumentacja jest okropna" nie jest ani pomocną ani uprzejmą opinią.
66+
67+

0 commit comments

Comments
 (0)