Synchronize Polish localization to 1.25, part 2

Synchronize Polish localization with the upstream
English version up to f612b11.
Part 2.

content/pl/docs/concepts/overview/kubernetes-api.md

@@ -21,7 +21,7 @@ API Kubernetesa pozwala na sprawdzanie i zmianę stanu obiektów
 (przykładowo: pody, _Namespaces_, _ConfigMaps_, _Events_).
 
 Większość operacji może zostać wykonana poprzez
-interfejs linii komend (CLI) [kubectl](/docs/reference/kubectl/overview/) lub inne
+interfejs linii komend (CLI) [kubectl](/docs/reference/kubectl/) lub inne
 programy, takie jak
 [kubeadm](/docs/reference/setup-tools/kubeadm/), które używają
 API. Możesz też korzystać z API bezpośrednio przez wywołania typu REST.
@@ -72,24 +72,51 @@ użyj nagłówków żądania zgodnie z tabelą:
 
 W Kubernetesie zaimplementowany jest alternatywny format serializacji na potrzeby API oparty o
 Protobuf, który jest przede wszystkim przeznaczony na potrzeby wewnętrznej komunikacji w klastrze.
-Więcej szczegółów znajduje się w dokumencie [Kubernetes Protobuf serialization](https://github.com/kubernetes/community/blob/master/contributors/design-proposals/api-machinery/protobuf.md).
+Więcej szczegółów znajduje się w dokumencie [Kubernetes Protobuf serialization](https://git.k8s.io/design-proposals-archive/api-machinery/protobuf.md).
 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" >}}
+{{< feature-state state="beta"  for_k8s_version="v1.24" >}}
 
-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
+Kubernetes {{< param "version" >}} publikuje (na razie w wersji roboczej) własne API zgodnie ze specyfikacją OpenAPI v3.
+Ta funkcjonalność jest w wersji _beta_ i jest domyślnie włączona.
+Funkcjonalności w wersji _beta_ można wyłą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.
+Pod adresem `/openapi/v3` można znaleźć listę wszystkich
+dostępnych grup/wersji. Zwracane wartości są dostępne tylko w formacie JSON. Grupy/wersje
+opisane są następującym schematem:
+
+```yaml
+{
+    "paths": {
+        ...,
+        "api/v1": {
+            "serverRelativeURL": "/openapi/v3/api/v1?hash=CC0E9BFD992D8C59AEC98A1E2336F899E8318D3CF4C68944C3DEC640AF5AB52D864AC50DAA8D145B3494F75FA3CFF939FCBDDA431DAD3CA79738B297795818CF"
+        },
+        "apis/admissionregistration.k8s.io/v1": {
+            "serverRelativeURL": "/openapi/v3/apis/admissionregistration.k8s.io/v1?hash=E19CC93A116982CE5422FC42B590A8AFAD92CDE9AE4D59B5CAAD568F083AD07946E6CB5817531680BCE6E215C16973CD39003B0425F3477CFD854E89A9DB6597"
+        },
+        ....
+    }
+}
+```
+<!-- for editors: intionally use yaml instead of json here, to prevent syntax highlight error. -->
+
+Względne adresy URL wskazują na niezmieniające się opisy OpenAPI,
+aby umożliwić trzymanie cache po stronie klienta. Serwer API zwraca
+również odpowiednie nagłówki HTTP dla cache (`Expires` ustawione na 1 rok wprzód,
+`Cache-Control` jako `immutable`). Wysłanie zapytania do nieaktualnego URL
+spowoduje przekierowanie przez serwer API do wersji najnowszej. 
+
+Serwer API Kubernetesa udostępnia specyfikację OpenAPI v3
+pod adresem `/openapi/v3/apis/<group>/<version>?hash=<hash>`,
+zgodnie z podziałem na grupy i wersje.
+
+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>
@@ -122,9 +149,6 @@ nagłówków żądania.
   </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

content/pl/docs/contribute/_index.md

@@ -17,8 +17,15 @@ card:
 {{< note >}}
 Aby dowiedzieć się więcej ogólnych informacji o współpracy przy tworzeniu Kubernetesa, zajrzyj
 do [contributor documentation](https://www.kubernetes.dev/docs/).
+
+Warto także zapoznać się z 
+[informacjami](https://contribute.cncf.io/contributors/projects/#kubernetes)
+{{< glossary_tooltip text="CNCF" term_id="cncf" >}}
+na temat współpracy w ramach projektu Kubernetes.
 {{< /note >}}
 
+---
+
 Tym serwisem www opiekuje się [Kubernetes SIG Docs](/docs/contribute/#get-involved-with-sig-docs).
 
 Współtwórcy dokumentacji Kubernetesa:
@@ -90,17 +97,17 @@ 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 >}}
-***Schemat - Jak zacząć współpracę***
+Schemat 1. - Jak rozpocząć współpracę
 
-To jest schemat postępowania dla osób, które chcą zacząć współtworzyć Kubernetesa. Przejdź część lub wszystkie kroki opisane w częściach `Zapisz się` i `Recenzuj`. Teraz już możesz tworzyć nowe PR, zgodnie z sugestiami w `Otwórz PR`. I jak zawsze, pytania mile widziane!
+Schemat 1 przeznaczony jest dla osób, które chcą zacząć współtworzyć Kubernetesa. Przejdź część lub wszystkie kroki opisane w częściach `Zapisz się` i `Recenzuj`. Teraz już możesz tworzyć nowe PR, zgodnie z sugestiami w `Otwórz PR`. I jak zawsze, pytania mile widziane!
 
 Do realizacji niektórych zadań potrzeba wyższego poziomu zaufania i odpowiednich uprawnień w organizacji Kubernetes.
 Zajrzyj do [Participating in SIG Docs](/docs/contribute/participate/) po więcej szczegółów dotyczących
 ról i uprawnień.
 
 ## Pierwsze kroki
 
-Zapoznaj się z krokami opisanymi poniżej, aby się lepiej przygotować.
+Zapoznaj się z krokami opisanymi na schemacie 2, aby się lepiej przygotować.
 
 <!-- See https://github.com/kubernetes/website/issues/28808 for live-editor URL to this figure -->
 <!-- You can also cut/paste the mermaid code into the live editor at https://mermaid-js.github.io/mermaid-live-editor to play around with it -->
@@ -110,7 +117,7 @@ flowchart LR
     subgraph second[Pierwszy wkład]
     direction TB
     S[ ] -.-
-    G[Obejrzyj PRy<br>innych uczestników K8s] -->
+    G[Obejrzyj PR-y<br>innych uczestników K8s] -->
     A[Przejrzyj listę zgłoszonych spraw<br>na K8s/website<br>po pomysł na nowy PR] --> B[Otwórz PR!!]
     end
     subgraph first[Sugerowane przygotowanie]
@@ -129,9 +136,9 @@ class A,B,D,E,F,G grey
 class S,T spacewhite
 class first,second white
 {{</ mermaid >}}
-***Schemat - Jak się przygotować***
+Schemat 2. - Jak się przygotować
 
-- Przeczytaj [Contribution overview](/docs/contribute/new-content/overview/),
+- Przeczytaj [Contribution overview](/docs/contribute/new-content/),
   aby dowiedzieć się o różnych sposobach współpracy.
 - Zajrzyj do [Contribute to kubernetes/website](https://github.com/kubernetes/website/contribute),
   aby znaleźć dobre zgłoszenie na początek.