From 65887b7e5d947a4a18d86965c6ed3e827d0fb08d Mon Sep 17 00:00:00 2001
From: Maciej Filocha <maciej.filocha@gmail.com>
Date: Sat, 22 Jan 2022 12:58:31 +0100
Subject: [PATCH] Synchronize Polish localization for ver 1.23, part 1

Synchronize Polish localization with upstream up to 285eb39e2e87dcdf4ab5e69669003562f1d25f24.
Part 1
---
 .../pl/docs/concepts/overview/components.md   |  2 +-
 .../docs/concepts/overview/kubernetes-api.md  | 54 ++++++++++++++++++-
 2 files changed, 53 insertions(+), 3 deletions(-)

diff --git a/content/pl/docs/concepts/overview/components.md b/content/pl/docs/concepts/overview/components.md
index a92eac2411..3f2b8a8135 100644
--- a/content/pl/docs/concepts/overview/components.md
+++ b/content/pl/docs/concepts/overview/components.md
@@ -15,7 +15,7 @@ W wyniku instalacji Kubernetesa otrzymujesz klaster.
 
 {{< glossary_definition term_id="cluster" length="all" prepend="Klaster Kubernetes to">}}
 
-W tym dokumencie opisujemy składniki niezbędne do zbudowania kompletnego, poprawnie działającego klastra Kubernetes.
+W tym dokumencie opisujemy składniki niezbędne do zbudowania kompletnego, poprawnie działającego klastra Kubernetesa.
 
 {{< figure src="/images/docs/components-of-kubernetes.svg" alt="Składniki Kubernetesa" caption="Części składowe klastra Kubernetes" class="diagram-large" >}}
 
diff --git a/content/pl/docs/concepts/overview/kubernetes-api.md b/content/pl/docs/concepts/overview/kubernetes-api.md
index 731b22cacc..3725e35925 100644
--- a/content/pl/docs/concepts/overview/kubernetes-api.md
+++ b/content/pl/docs/concepts/overview/kubernetes-api.md
@@ -35,8 +35,9 @@ warto rozważyć użycie jednej z [bibliotek klienckich](/docs/reference/using-a
 
 Pełną specyfikację API udokumentowano za pomocą [OpenAPI](https://www.openapis.org/).
 
-Serwer API Kubernetes API udostępnia specyfikację OpenAPI poprzez ścieżkę `/openapi/v2`.
-Aby wybrać format odpowiedzi, użyj nagłówków żądania zgodnie z tabelą:
+Serwer API Kubernetesa udostępnia specyfikację OpenAPI poprzez
+ścieżkę `/openapi/v2`. Aby wybrać format odpowiedzi,
+użyj nagłówków żądania zgodnie z tabelą:
 
 <table>
 <caption style="display:none">Dopuszczalne wartości nagłówka żądania dla zapytań OpenAPI v2</caption>
@@ -75,6 +76,55 @@ Więcej szczegółów znajduje się w dokumencie [Kubernetes Protobuf serializat
 oraz w plikach *Interface Definition Language* (IDL) dla każdego ze schematów
 zamieszczonych w pakietach Go, które definiują obiekty API.
 
+### OpenAPI V3
+
+{{< feature-state state="alpha"  for_k8s_version="v1.23" >}}
+
+Kubernetes v1.23 umożliwia (na razie w we wczesnej wersji roboczej) publikowanie swojego API jako OpenAPI v3.
+Ta funkcjonalność jest w wersji _alfa_ i jest domyślnie wyłączona.
+Funkcjonalności w wersji _alfa_ można włączać poprzez
+[feature gate](/docs/reference/command-line-tools-reference/feature-gates/) o nazwie `OpenAPIV3`
+składnika kube-apiserver.
+
+Po włączeniu tej funkcjonalności, serwer API Kubernetesa udostępnia
+zagregowaną specyfikację OpenAPI v3 dla odpowiednich grup i wersji poprzez ścieżkę
+`/openapi/v3/apis/<group>/<version>`. Tabela poniżej podaje dopuszczalne wartości
+nagłówków żądania.
+
+<table>
+  <caption style="display:none">Dopuszczalne wartości nagłówka żądania dla zapytań OpenAPI v3</caption>
+  <thead>
+     <tr>
+        <th>Nagłówek</th>
+        <th style="min-width: 50%;">Dopuszczalne wartości</th>
+        <th>Uwagi</th>
+     </tr>
+  </thead>
+  <tbody>
+     <tr>
+        <td><code>Accept-Encoding</code></td>
+        <td><code>gzip</code></td>
+        <td><em>pominięcie tego nagłówka jest dozwolone</em></td>
+     </tr>
+     <tr>
+        <td rowspan="3"><code>Accept</code></td>
+        <td><code>application/com.github.proto-openapi.spec.v3@v1.0+protobuf</code></td>
+        <td><em>głównie do celu komunikacji wewnątrz klastra</em></td>
+     </tr>
+     <tr>
+        <td><code>application/json</code></td>
+        <td><em>domyślne</em></td>
+     </tr>
+     <tr>
+        <td><code>*</code></td>
+        <td><em>udostępnia </em><code>application/json</code></td>
+     </tr>
+  </tbody>
+</table>
+
+Poprzez ścieżkę `/openapi/v3` można wyświetlić pełną listę
+dostępnych grup i wersji. Formatem odpowiedzi jest tylko JSON.
+
 ## Przechowywanie stanu
 
 Kubernetes przechowuje serializowany stan swoich obiektów w