From aed5ae9a0dc0a88473c4cbacd0fd0c397b655117 Mon Sep 17 00:00:00 2001 From: dkarczmarski Date: Wed, 5 Feb 2025 15:07:30 +0100 Subject: [PATCH] [pl] docs/contribute/style/content-guide.md --- .../pl/docs/contribute/style/content-guide.md | 74 +++++++++++++++++++ 1 file changed, 74 insertions(+) create mode 100644 content/pl/docs/contribute/style/content-guide.md diff --git a/content/pl/docs/contribute/style/content-guide.md b/content/pl/docs/contribute/style/content-guide.md new file mode 100644 index 0000000000000..e54e2590878ca --- /dev/null +++ b/content/pl/docs/contribute/style/content-guide.md @@ -0,0 +1,74 @@ +--- +title: Przewodnik treści +linktitle: Przewodnik treści +content_type: concept +weight: 10 +--- + + + +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). + + + +## 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//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—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).