Skip to content

[pl] docs/contribute/style/content-guide.md #49658

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

Open
wants to merge 1 commit 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
74 changes: 74 additions & 0 deletions content/pl/docs/contribute/style/content-guide.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,74 @@
---
title: Przewodnik treści
linktitle: Przewodnik treści
content_type: concept
weight: 10
---

<!-- overview -->

Ta strona zawiera wytyczne dotyczące dokumentacji Kubernetesa.

Jeśli masz pytania dotyczące tego, co jest dozwolone, dołącz do
kanału #sig-docs w [Kubernetes Slack](https://slack.k8s.io/) i zapytaj!

Możesz zarejestrować się na Kubernetes Slack pod adresem https://slack.k8s.io/.

Aby uzyskać informacje na temat tworzenia nowych treści do dokumentacji
Kubernetesa, postępuj zgodnie z [przewodnikiem stylu](/docs/contribute/style/style-guide).

<!-- body -->

## Przegląd {#overview}

Źródło dla strony internetowej Kubernetesa, w tym dokumentacji, znajduje
się w repozytorium [kubernetes/website](https://github.com/kubernetes/website).

Znajdująca się w folderze `kubernetes/website/content/<language_code>/docs`,
większość dokumentacji Kubernetesa jest specyficzna dla
[projektu Kubernetes](https://github.com/kubernetes/kubernetes).

## Co jest dozwolone {#whats-allowed}

Dokumentacja Kubernetesa akceptuje materiały o projektach firm trzecich tylko pod warunkiem, że:

- Zawartość dokumentuje oprogramowanie w projekcie Kubernetes
- Zawartość dokumentuje oprogramowanie, które znajduje się poza projektem, ale jest niezbędne do działania Kubernetesa.
- Treści są kanoniczne na kubernetes.io lub odsyłają do kanonicznych treści w innym miejscu

### Treści firm trzecich {#third-party-content}

Dokumentacja Kubernetesa zawiera zastosowane przykłady projektów w projekcie
Kubernetes&mdash;projektów znajdujących się w organizacjach GitHub
[kubernetes](https://github.com/kubernetes) i [kubernetes-sigs](https://github.com/kubernetes-sigs).

Linki do aktywnej zawartości w projekcie Kubernetes są zawsze dozwolone.

Kubernetes wymaga pewnych zewnętrznych treści, aby działać. Przykłady obejmują środowiska
uruchomieniowe kontenerów (containerd, CRI-O, Docker), [zasady sieciowe](/docs/concepts/extend-kubernetes/compute-storage-net/network-plugins/)
(wtyczki CNI),
[kontrolery Ingress](/docs/concepts/services-networking/ingress-controllers/) oraz [logowanie](/docs/concepts/cluster-administration/logging/).

Dokumentacja może odnosić się do zewnętrznego oprogramowania open source (OSS)
spoza projektu Kubernetesa tylko wtedy, gdy jest to niezbędne do działania Kubernetes.

### Zduplikowane treści {#dual-sourced-content}

W miarę możliwości dokumentacja Kubernetesa odsyła do
kanonicznych źródeł zamiast hostować zduplikowaną treść.

Zduplikowana treść wymaga podwójnego wysiłku (lub
więcej!) do utrzymania i szybciej staje się nieaktualna.

{{< note >}}
Jeśli jesteś opiekunem projektu Kubernetes i potrzebujesz pomocy w hostowaniu własnej dokumentacji, poproś
o pomoc na [#sig-docs na Kubernetes Slack](https://kubernetes.slack.com/messages/C1J0BPD2M/).
{{< /note >}}

### Więcej informacji {#more-information}

Jeśli masz pytania dotyczące dozwolonej treści, dołącz do kanału [Kubernetes Slack](https://slack.k8s.io/) #sig-docs i zapytaj!

## {{% heading "whatsnext" %}}

* Przeczytaj [Przewodnik stylu](/docs/contribute/style/style-guide).