diff --git a/docs/07-Release Notes/v0.22/v0.22.0.md b/docs/07-Release Notes/v0.22/v0.22.0.md
index 4af164d8..2821df29 100644
--- a/docs/07-Release Notes/v0.22/v0.22.0.md	
+++ b/docs/07-Release Notes/v0.22/v0.22.0.md	
@@ -1,7 +1,7 @@
 ---
 slug: /release-notes/v0.22.0
 title: v0.22.0
-sidebar_position: 22
+sidebar_position: 23
 ---
 # metal-stack v0.22.0
 See original release note at [https://github.com/metal-stack/releases/releases/tag/v0.22.0](https://github.com/metal-stack/releases/releases/tag/v0.22.0)
diff --git a/docs/07-Release Notes/v0.22/v0.22.1.md b/docs/07-Release Notes/v0.22/v0.22.1.md
index eb05b166..155e42ba 100644
--- a/docs/07-Release Notes/v0.22/v0.22.1.md	
+++ b/docs/07-Release Notes/v0.22/v0.22.1.md	
@@ -1,7 +1,7 @@
 ---
 slug: /release-notes/v0.22.1
 title: v0.22.1
-sidebar_position: 21
+sidebar_position: 22
 ---
 # metal-stack v0.22.1
 See original release note at [https://github.com/metal-stack/releases/releases/tag/v0.22.1](https://github.com/metal-stack/releases/releases/tag/v0.22.1)
diff --git a/docs/07-Release Notes/v0.22/v0.22.10.md b/docs/07-Release Notes/v0.22/v0.22.10.md
index 4814412c..38a23d08 100644
--- a/docs/07-Release Notes/v0.22/v0.22.10.md	
+++ b/docs/07-Release Notes/v0.22/v0.22.10.md	
@@ -1,7 +1,7 @@
 ---
 slug: /release-notes/v0.22.10
 title: v0.22.10
-sidebar_position: 12
+sidebar_position: 13
 ---
 # metal-stack v0.22.10
 See original release note at [https://github.com/metal-stack/releases/releases/tag/v0.22.10](https://github.com/metal-stack/releases/releases/tag/v0.22.10)
diff --git a/docs/07-Release Notes/v0.22/v0.22.11.md b/docs/07-Release Notes/v0.22/v0.22.11.md
index fe533256..f558e5ba 100644
--- a/docs/07-Release Notes/v0.22/v0.22.11.md	
+++ b/docs/07-Release Notes/v0.22/v0.22.11.md	
@@ -1,7 +1,7 @@
 ---
 slug: /release-notes/v0.22.11
 title: v0.22.11
-sidebar_position: 11
+sidebar_position: 12
 ---
 # metal-stack v0.22.11
 See original release note at [https://github.com/metal-stack/releases/releases/tag/v0.22.11](https://github.com/metal-stack/releases/releases/tag/v0.22.11)
diff --git a/docs/07-Release Notes/v0.22/v0.22.12.md b/docs/07-Release Notes/v0.22/v0.22.12.md
index 4a7d2591..7e38e773 100644
--- a/docs/07-Release Notes/v0.22/v0.22.12.md	
+++ b/docs/07-Release Notes/v0.22/v0.22.12.md	
@@ -1,7 +1,7 @@
 ---
 slug: /release-notes/v0.22.12
 title: v0.22.12
-sidebar_position: 10
+sidebar_position: 11
 ---
 # metal-stack v0.22.12
 See original release note at [https://github.com/metal-stack/releases/releases/tag/v0.22.12](https://github.com/metal-stack/releases/releases/tag/v0.22.12)
diff --git a/docs/07-Release Notes/v0.22/v0.22.13.md b/docs/07-Release Notes/v0.22/v0.22.13.md
index 4898f56b..9c3fde29 100644
--- a/docs/07-Release Notes/v0.22/v0.22.13.md	
+++ b/docs/07-Release Notes/v0.22/v0.22.13.md	
@@ -1,7 +1,7 @@
 ---
 slug: /release-notes/v0.22.13
 title: v0.22.13
-sidebar_position: 9
+sidebar_position: 10
 ---
 # metal-stack v0.22.13
 See original release note at [https://github.com/metal-stack/releases/releases/tag/v0.22.13](https://github.com/metal-stack/releases/releases/tag/v0.22.13)
diff --git a/docs/07-Release Notes/v0.22/v0.22.14.md b/docs/07-Release Notes/v0.22/v0.22.14.md
index ee80f025..0b3e6082 100644
--- a/docs/07-Release Notes/v0.22/v0.22.14.md	
+++ b/docs/07-Release Notes/v0.22/v0.22.14.md	
@@ -1,7 +1,7 @@
 ---
 slug: /release-notes/v0.22.14
 title: v0.22.14
-sidebar_position: 8
+sidebar_position: 9
 ---
 # metal-stack v0.22.14
 See original release note at [https://github.com/metal-stack/releases/releases/tag/v0.22.14](https://github.com/metal-stack/releases/releases/tag/v0.22.14)
diff --git a/docs/07-Release Notes/v0.22/v0.22.15.md b/docs/07-Release Notes/v0.22/v0.22.15.md
index 37c16ece..62f731d0 100644
--- a/docs/07-Release Notes/v0.22/v0.22.15.md	
+++ b/docs/07-Release Notes/v0.22/v0.22.15.md	
@@ -1,7 +1,7 @@
 ---
 slug: /release-notes/v0.22.15
 title: v0.22.15
-sidebar_position: 7
+sidebar_position: 8
 ---
 # metal-stack v0.22.15
 See original release note at [https://github.com/metal-stack/releases/releases/tag/v0.22.15](https://github.com/metal-stack/releases/releases/tag/v0.22.15)
diff --git a/docs/07-Release Notes/v0.22/v0.22.16.md b/docs/07-Release Notes/v0.22/v0.22.16.md
index 7782a49f..18e40c84 100644
--- a/docs/07-Release Notes/v0.22/v0.22.16.md	
+++ b/docs/07-Release Notes/v0.22/v0.22.16.md	
@@ -1,7 +1,7 @@
 ---
 slug: /release-notes/v0.22.16
 title: v0.22.16
-sidebar_position: 6
+sidebar_position: 7
 ---
 # metal-stack v0.22.16
 See original release note at [https://github.com/metal-stack/releases/releases/tag/v0.22.16](https://github.com/metal-stack/releases/releases/tag/v0.22.16)
diff --git a/docs/07-Release Notes/v0.22/v0.22.17.md b/docs/07-Release Notes/v0.22/v0.22.17.md
index 27d900d3..2870437e 100644
--- a/docs/07-Release Notes/v0.22/v0.22.17.md	
+++ b/docs/07-Release Notes/v0.22/v0.22.17.md	
@@ -1,7 +1,7 @@
 ---
 slug: /release-notes/v0.22.17
 title: v0.22.17
-sidebar_position: 5
+sidebar_position: 6
 ---
 # metal-stack v0.22.17
 See original release note at [https://github.com/metal-stack/releases/releases/tag/v0.22.17](https://github.com/metal-stack/releases/releases/tag/v0.22.17)
diff --git a/docs/07-Release Notes/v0.22/v0.22.18.md b/docs/07-Release Notes/v0.22/v0.22.18.md
index c48d3f66..03cc9679 100644
--- a/docs/07-Release Notes/v0.22/v0.22.18.md	
+++ b/docs/07-Release Notes/v0.22/v0.22.18.md	
@@ -1,7 +1,7 @@
 ---
 slug: /release-notes/v0.22.18
 title: v0.22.18
-sidebar_position: 4
+sidebar_position: 5
 ---
 # metal-stack v0.22.18
 See original release note at [https://github.com/metal-stack/releases/releases/tag/v0.22.18](https://github.com/metal-stack/releases/releases/tag/v0.22.18)
diff --git a/docs/07-Release Notes/v0.22/v0.22.19.md b/docs/07-Release Notes/v0.22/v0.22.19.md
index f3821d0c..d9d9ec6b 100644
--- a/docs/07-Release Notes/v0.22/v0.22.19.md	
+++ b/docs/07-Release Notes/v0.22/v0.22.19.md	
@@ -1,7 +1,7 @@
 ---
 slug: /release-notes/v0.22.19
 title: v0.22.19
-sidebar_position: 3
+sidebar_position: 4
 ---
 # metal-stack v0.22.19
 See original release note at [https://github.com/metal-stack/releases/releases/tag/v0.22.19](https://github.com/metal-stack/releases/releases/tag/v0.22.19)
diff --git a/docs/07-Release Notes/v0.22/v0.22.2.md b/docs/07-Release Notes/v0.22/v0.22.2.md
index 6165d809..b64ea0c0 100644
--- a/docs/07-Release Notes/v0.22/v0.22.2.md	
+++ b/docs/07-Release Notes/v0.22/v0.22.2.md	
@@ -1,7 +1,7 @@
 ---
 slug: /release-notes/v0.22.2
 title: v0.22.2
-sidebar_position: 20
+sidebar_position: 21
 ---
 # metal-stack v0.22.2
 See original release note at [https://github.com/metal-stack/releases/releases/tag/v0.22.2](https://github.com/metal-stack/releases/releases/tag/v0.22.2)
diff --git a/docs/07-Release Notes/v0.22/v0.22.20.md b/docs/07-Release Notes/v0.22/v0.22.20.md
index cd27b04e..0ab0dbfa 100644
--- a/docs/07-Release Notes/v0.22/v0.22.20.md	
+++ b/docs/07-Release Notes/v0.22/v0.22.20.md	
@@ -1,7 +1,7 @@
 ---
 slug: /release-notes/v0.22.20
 title: v0.22.20
-sidebar_position: 2
+sidebar_position: 3
 ---
 # metal-stack v0.22.20
 See original release note at [https://github.com/metal-stack/releases/releases/tag/v0.22.20](https://github.com/metal-stack/releases/releases/tag/v0.22.20)
diff --git a/docs/07-Release Notes/v0.22/v0.22.21.md b/docs/07-Release Notes/v0.22/v0.22.21.md
index c39c49fb..0db1c4af 100644
--- a/docs/07-Release Notes/v0.22/v0.22.21.md	
+++ b/docs/07-Release Notes/v0.22/v0.22.21.md	
@@ -1,12 +1,13 @@
 ---
 slug: /release-notes/v0.22.21
 title: v0.22.21
-sidebar_position: 1
+sidebar_position: 2
 ---
 # metal-stack v0.22.21
 See original release note at [https://github.com/metal-stack/releases/releases/tag/v0.22.21](https://github.com/metal-stack/releases/releases/tag/v0.22.21)
 ## General
 * [Gardener v1.140](https://github.com/gardener/gardener/releases/tag/v1.140.0)
+* This release was integration tested against the control plane that fully uses Gateway API and without anymore Ingress resources. We recommend to migrate to Gateway API for this release.
 ## Noteworthy
 * Add environment variables support to cosign verify. (metal-stack/ansible-common#50)
 * Prometheus in the partition monitoring role can now be configured with additional labels. As some systems use `replica` while others use `__replica__` that may conflict, the label: `replica: '{{ inventory_hostname }}'` has been added to the defaults. If you make use of this configuration option and want to keep the `replica` label, make sure to include it explicitly. (metal-stack/metal-roles#702)
diff --git a/docs/07-Release Notes/v0.22/v0.22.22.md b/docs/07-Release Notes/v0.22/v0.22.22.md
new file mode 100644
index 00000000..6cd17a1e
--- /dev/null
+++ b/docs/07-Release Notes/v0.22/v0.22.22.md	
@@ -0,0 +1,81 @@
+---
+slug: /release-notes/v0.22.22
+title: v0.22.22
+sidebar_position: 1
+---
+# metal-stack v0.22.22
+See original release note at [https://github.com/metal-stack/releases/releases/tag/v0.22.22](https://github.com/metal-stack/releases/releases/tag/v0.22.22)
+## General
+* [Gardener v1.141](https://github.com/gardener/gardener/releases/tag/v1.141.0)
+  - ⚠️ Gardener does no longer support Garden, Seed, or Shoot clusters with Kubernetes versions <= 1.30. Make sure to upgrade all existing clusters before upgrading to this Gardener version.
+* This release was integration tested against the control plane that fully uses Gateway API and without anymore Ingress resources. We recommend to migrate to Gateway API for this release.
+## Required Actions
+* The metal-image-cache-sync is the first component to be migrated to use the V2 metal-stack API by communicating with the metal-apiserver. To deploy it, please take care of the following tasks:
+  
+  - Add the role `metal-roles/common/roles/metal-v2-client` to your partition playbook to install the Python API V2 client into the deployment runner.
+  - Make sure the metal-apiserver is running in the control-plane. 
+  - Ensure that the new variables `defaults_partition_metal_apiserver_url` and `defaults_partition_metal_apiserver_admin_token` are provided through inventory. We advice to provide the partition deployment token by manually creating it through the metalctlv2 CLI and storing it ansible-vaulted in the inventory. Renewal cycles of this token are up to the deployment operator. (metal-stack/metal-roles#453)
+## Breaking Changes
+* The metal-image-cache-sync has been migrated to the metal-stack V2 API. This means that it is no longer possible to connect to the metal-api, but instead to the new metal-apiserver, which was introduced in an earlier release. Please check the metal-roles release notes and adapt your deployment accordingly. (metal-stack/metal-image-cache-sync#21)
+* The `metal_apiserver_session_secret` variable is now required. Make sure that it set in your deployment and has a length >= 10 characters. (metal-stack/metal-roles#725)
+* `dhcp_relay_src_intf` and `dhcp_relay_server_vrf` are no longer set automatically when `dhcp_servers` are defined but must be set explicitly. (metal-stack/sonic-configdb-utils#50)
+## Component Releases
+### gardener-extension-dns-powerdns v0.8.0
+* Fix RBACs for runtime clusters. (metal-stack/gardener-extension-dns-powerdns#16) @Gerrit91
+* Update README and actions. (metal-stack/gardener-extension-dns-powerdns#17) @Gerrit91
+### api v0.5.1
+* Make switch nic mac optional (metal-stack/api#182) @iljarotar
+* Machine BMC List must have MachineQuery instead of MachineBMCQuery (metal-stack/api#179) @majst01
+* PlacementLabels, and b64 encoded userdata (metal-stack/api#180) @majst01
+* If tokenfile instead of token is specified, no reread happens (metal-stack/api#178) @majst01
+* Fix js generate (metal-stack/api#177) @iljarotar
+* Fix punctuation in docstrings (metal-stack/api#175) @majst01
+* Add generic Typescript client (metal-stack/api#171) @majst01
+* Fix npm publish (metal-stack/api#183) @iljarotar
+### metal-apiserver v0.10.0
+* Allow nil mac for switch nics (metal-stack/metal-apiserver#287) @iljarotar
+* Update err msg to match check (metal-stack/metal-apiserver#284) @eberlep
+* Fix machine bmc list (metal-stack/metal-apiserver#285) @majst01
+* Adapt to latest API (placement labels + b64 userdata). (metal-stack/metal-apiserver#286) @Gerrit91
+* Update protovalidate (metal-stack/metal-apiserver#283) @majst01
+* Update deps, remove replaces (metal-stack/metal-apiserver#281) @majst01
+* Allow changing port status of unconnected ports (metal-stack/metal-apiserver#282) @iljarotar
+* Add image labels. (metal-stack/metal-apiserver#279) @Gerrit91
+### metal-image-cache-sync v0.2.0
+* Migrate to V2 API (metal-stack/metal-image-cache-sync#21) @majst01
+* Update actions workflows and dependencies. (metal-stack/metal-image-cache-sync#26) @Gerrit91
+* include sbom in container image (metal-stack/metal-image-cache-sync#20) @mac641
+* Migrate to golangci lint v2 and satisfy new warnings (metal-stack/metal-image-cache-sync#19) @majst01
+### sonic-configdb-utils v0.6.1
+* Allow adding src_intf and server_vrf to dhcp_relay (metal-stack/sonic-configdb-utils#45) @iljarotar
+* Allow adding additional numbered interfaces (metal-stack/sonic-configdb-utils#44) @iljarotar
+* Use substring matching for version checking for latest 202211 sonic version (metal-stack/sonic-configdb-utils#35) @mreiger
+* Dependabot mongo driver 1 17 7 (metal-stack/sonic-configdb-utils#49) @iljarotar
+* Cleanup vlan dhcp_relay (metal-stack/sonic-configdb-utils#48) @iljarotar
+* Dhcp relay src intf and server vrf (metal-stack/sonic-configdb-utils#47) @iljarotar
+### metal-roles v0.32.1
+* Migrate metal-image-cache-sync to V2 API (metal-stack/metal-roles#453) @majst01
+* Make `metal_apiserver_session_secret` required. (metal-stack/metal-roles#725) @Gerrit91
+* Add ansible variable to configure OIDC ID for metal-apiserver (metal-stack/metal-roles#718) @simcod, @Gerrit91
+* Add configuration options for auditing and valkey (metal-stack/metal-roles#701) @simcod
+* fix(isolated clusters):  add cilium to oci-mirror-config (metal-stack/metal-roles#735) @mwennrich
+* Refactor gardener-metrics-exporter and refresher configuration options (metal-stack/metal-roles#726) @simcod
+* Remove unused gardener ingress nginx variable. (metal-stack/metal-roles#727) @Gerrit91
+* Increase default token expiration for image-cache. (metal-stack/metal-roles#731) @Gerrit91
+### metal-token-refresher v0.1.0
+* refactor(tests): drop mocks in favor of interceptors (metal-stack/metal-token-refresher#5) @vknabel
+* Github actions permissions for dependabot. (metal-stack/metal-token-refresher#3) @Gerrit91
+* build(deps): bump github.com/metal-stack/api from 0.2.3 to 0.2.6 in the metal-stack group (metal-stack/metal-token-refresher#2) [@dependabot[bot]](https://github.com/apps/dependabot)
+* chore(ci): minimal permissions for spell-check workflow (metal-stack/metal-token-refresher#4) @vknabel
+# Merged Pull Requests
+This is a list of pull requests that were merged since the last release. The list does not contain pull requests from release-vector-repositories.
+
+The fact that these pull requests were merged does not necessarily imply that they have already become part of this metal-stack release.
+
+* Generic enum completion, switch os in list view (metal-stack/cli#54) @majst01
+* Adapt to API v0.5.0 (metal-stack/cli#55) @Gerrit91
+* Gardener 1.141.6 (metal-stack/releases#317) @vknabel
+* Bump releases to version v0.22.21 (metal-stack/website#345) @metal-robot[bot]
+* Update Ubuntu kernel to v6.18.44 (metal-stack/metal-images#439) @mwennrich
+* Go 1.27 (metal-stack/cli#57) @majst01
+* Next release (metal-stack/releases#316) @metal-robot[bot]
\ No newline at end of file
diff --git a/docs/07-Release Notes/v0.22/v0.22.3.md b/docs/07-Release Notes/v0.22/v0.22.3.md
index 1541ca9f..8c4802dd 100644
--- a/docs/07-Release Notes/v0.22/v0.22.3.md	
+++ b/docs/07-Release Notes/v0.22/v0.22.3.md	
@@ -1,7 +1,7 @@
 ---
 slug: /release-notes/v0.22.3
 title: v0.22.3
-sidebar_position: 19
+sidebar_position: 20
 ---
 # metal-stack v0.22.3
 See original release note at [https://github.com/metal-stack/releases/releases/tag/v0.22.3](https://github.com/metal-stack/releases/releases/tag/v0.22.3)
diff --git a/docs/07-Release Notes/v0.22/v0.22.4.md b/docs/07-Release Notes/v0.22/v0.22.4.md
index a500952d..a4e2038b 100644
--- a/docs/07-Release Notes/v0.22/v0.22.4.md	
+++ b/docs/07-Release Notes/v0.22/v0.22.4.md	
@@ -1,7 +1,7 @@
 ---
 slug: /release-notes/v0.22.4
 title: v0.22.4
-sidebar_position: 18
+sidebar_position: 19
 ---
 # metal-stack v0.22.4
 See original release note at [https://github.com/metal-stack/releases/releases/tag/v0.22.4](https://github.com/metal-stack/releases/releases/tag/v0.22.4)
diff --git a/docs/07-Release Notes/v0.22/v0.22.5.md b/docs/07-Release Notes/v0.22/v0.22.5.md
index cc6a807e..9c9c7d6f 100644
--- a/docs/07-Release Notes/v0.22/v0.22.5.md	
+++ b/docs/07-Release Notes/v0.22/v0.22.5.md	
@@ -1,7 +1,7 @@
 ---
 slug: /release-notes/v0.22.5
 title: v0.22.5
-sidebar_position: 17
+sidebar_position: 18
 ---
 # metal-stack v0.22.5
 See original release note at [https://github.com/metal-stack/releases/releases/tag/v0.22.5](https://github.com/metal-stack/releases/releases/tag/v0.22.5)
diff --git a/docs/07-Release Notes/v0.22/v0.22.6.md b/docs/07-Release Notes/v0.22/v0.22.6.md
index 3a87d147..0a70bceb 100644
--- a/docs/07-Release Notes/v0.22/v0.22.6.md	
+++ b/docs/07-Release Notes/v0.22/v0.22.6.md	
@@ -1,7 +1,7 @@
 ---
 slug: /release-notes/v0.22.6
 title: v0.22.6
-sidebar_position: 16
+sidebar_position: 17
 ---
 # metal-stack v0.22.6
 See original release note at [https://github.com/metal-stack/releases/releases/tag/v0.22.6](https://github.com/metal-stack/releases/releases/tag/v0.22.6)
diff --git a/docs/07-Release Notes/v0.22/v0.22.7.md b/docs/07-Release Notes/v0.22/v0.22.7.md
index babf9aa3..003f797d 100644
--- a/docs/07-Release Notes/v0.22/v0.22.7.md	
+++ b/docs/07-Release Notes/v0.22/v0.22.7.md	
@@ -1,7 +1,7 @@
 ---
 slug: /release-notes/v0.22.7
 title: v0.22.7
-sidebar_position: 15
+sidebar_position: 16
 ---
 # metal-stack v0.22.7
 See original release note at [https://github.com/metal-stack/releases/releases/tag/v0.22.7](https://github.com/metal-stack/releases/releases/tag/v0.22.7)
diff --git a/docs/07-Release Notes/v0.22/v0.22.8.md b/docs/07-Release Notes/v0.22/v0.22.8.md
index 420dae1b..b57000a4 100644
--- a/docs/07-Release Notes/v0.22/v0.22.8.md	
+++ b/docs/07-Release Notes/v0.22/v0.22.8.md	
@@ -1,7 +1,7 @@
 ---
 slug: /release-notes/v0.22.8
 title: v0.22.8
-sidebar_position: 14
+sidebar_position: 15
 ---
 # metal-stack v0.22.8
 See original release note at [https://github.com/metal-stack/releases/releases/tag/v0.22.8](https://github.com/metal-stack/releases/releases/tag/v0.22.8)
diff --git a/docs/07-Release Notes/v0.22/v0.22.9.md b/docs/07-Release Notes/v0.22/v0.22.9.md
index c783a42a..eccf7d2b 100644
--- a/docs/07-Release Notes/v0.22/v0.22.9.md	
+++ b/docs/07-Release Notes/v0.22/v0.22.9.md	
@@ -1,7 +1,7 @@
 ---
 slug: /release-notes/v0.22.9
 title: v0.22.9
-sidebar_position: 13
+sidebar_position: 14
 ---
 # metal-stack v0.22.9
 See original release note at [https://github.com/metal-stack/releases/releases/tag/v0.22.9](https://github.com/metal-stack/releases/releases/tag/v0.22.9)
diff --git a/docs/08-References/Gardener/os-metal-extension/os-metal-extension.md b/docs/08-References/Gardener/os-metal-extension/os-metal-extension.md
index 38706cfc..8eb63d06 100644
--- a/docs/08-References/Gardener/os-metal-extension/os-metal-extension.md
+++ b/docs/08-References/Gardener/os-metal-extension/os-metal-extension.md
@@ -6,6 +6,26 @@ sidebar_position: 5
 
 # os-metal-extension
 
-This extension provides controllers to reconcile `OperatingSystemConfig`s and transforms them into [Ignition](https://www.flatcar.org/docs/latest/provisioning/ignition/) userdata. This userdata can be applied during machine provisioning as done by the metal-stack project.
+[![GitHub License](https://img.shields.io/github/license/metal-stack/os-metal-extension)](https://github.com/metal-stack/os-metal-extension/blob/master/LICENCE)
+[![Build](https://github.com/metal-stack/os-metal-extension/actions/workflows/build.yaml/badge.svg)](https://github.com/metal-stack/os-metal-extension/actions/workflows/build.yaml)
+
+This controller operates on the [`OperatingSystemConfig`](https://github.com/gardener/gardener/blob/master/docs/proposals/01-extensibility.md#cloud-config-user-data-for-bootstrapping-machines) resource in the `extensions.gardener.cloud/v1alpha1` API group. It manages those objects that are requesting:
+
+- [Ubuntu](https://www.ubuntu.com/) configuration (`.spec.type=ubuntu`)
+- [Debian](https://www.debian.org/) configuration (`.spec.type=debian`)
+
+In comparison to the official OSC extensions from Gardener, this extension transforms the `OperatingSystemConfig` resources into [Ignition](https://www.flatcar.org/docs/latest/provisioning/ignition/) userdata. This userdata can be applied during machine provisioning as done by the metal-stack project.
 
 This extension was made for working with operating system images built in the [metal-images](https://github.com/metal-stack/metal-images) repository.
+
+## Example
+
+An example `ControllerRegistration` resource that can be used to register this controller to Gardener can be found [here](example/controller-registration.yaml).
+
+## Development
+
+Development currently needs to happen against a real environment because there are many dependencies to external APIs for reconciliation. It is planned to allow development in the [mini-lab](https://github.com/metal-stack/mini-lab) soon.
+
+## Feedback and Support
+
+Feedback and contributions are always welcome! Please report bugs or suggestions as [GitHub issues](https://github.com/metal-stack/os-metal-extension/issues) or reach out to our [community](https://metal-stack.io/community).
diff --git a/scripts/components.json b/scripts/components.json
index 059dc2a4..5c5a45d1 100644
--- a/scripts/components.json
+++ b/scripts/components.json
@@ -66,7 +66,7 @@
         "releasePath": "docker-images.metal-stack.control-plane.metal-apiserver.tag",
         "repo": "metal-stack/metal-apiserver",
         "branch": "main",
-        "tag": "v0.9.1",
+        "tag": "v0.10.0",
         "position": 6,
         "withDocs": false
       },
@@ -248,7 +248,7 @@
         "releasePath": "docker-images.metal-stack.kubernetes.metal-token-refresher.tag",
         "repo": "metal-stack/metal-token-refresher",
         "branch": "better-readme",
-        "tag": "v0.0.1",
+        "tag": "v0.1.0",
         "position": 6,
         "withDocs": false
       }
diff --git a/src/version.json b/src/version.json
index 504d09fc..d55571ea 100644
--- a/src/version.json
+++ b/src/version.json
@@ -1 +1 @@
-{"version": "v0.22.21"}
+{"version": "v0.22.22"}
diff --git a/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.0.md b/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.0.md
index 4af164d8..2821df29 100644
--- a/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.0.md	
+++ b/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.0.md	
@@ -1,7 +1,7 @@
 ---
 slug: /release-notes/v0.22.0
 title: v0.22.0
-sidebar_position: 22
+sidebar_position: 23
 ---
 # metal-stack v0.22.0
 See original release note at [https://github.com/metal-stack/releases/releases/tag/v0.22.0](https://github.com/metal-stack/releases/releases/tag/v0.22.0)
diff --git a/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.1.md b/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.1.md
index eb05b166..155e42ba 100644
--- a/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.1.md	
+++ b/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.1.md	
@@ -1,7 +1,7 @@
 ---
 slug: /release-notes/v0.22.1
 title: v0.22.1
-sidebar_position: 21
+sidebar_position: 22
 ---
 # metal-stack v0.22.1
 See original release note at [https://github.com/metal-stack/releases/releases/tag/v0.22.1](https://github.com/metal-stack/releases/releases/tag/v0.22.1)
diff --git a/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.10.md b/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.10.md
index 4814412c..38a23d08 100644
--- a/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.10.md	
+++ b/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.10.md	
@@ -1,7 +1,7 @@
 ---
 slug: /release-notes/v0.22.10
 title: v0.22.10
-sidebar_position: 12
+sidebar_position: 13
 ---
 # metal-stack v0.22.10
 See original release note at [https://github.com/metal-stack/releases/releases/tag/v0.22.10](https://github.com/metal-stack/releases/releases/tag/v0.22.10)
diff --git a/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.11.md b/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.11.md
index fe533256..f558e5ba 100644
--- a/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.11.md	
+++ b/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.11.md	
@@ -1,7 +1,7 @@
 ---
 slug: /release-notes/v0.22.11
 title: v0.22.11
-sidebar_position: 11
+sidebar_position: 12
 ---
 # metal-stack v0.22.11
 See original release note at [https://github.com/metal-stack/releases/releases/tag/v0.22.11](https://github.com/metal-stack/releases/releases/tag/v0.22.11)
diff --git a/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.12.md b/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.12.md
index 4a7d2591..7e38e773 100644
--- a/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.12.md	
+++ b/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.12.md	
@@ -1,7 +1,7 @@
 ---
 slug: /release-notes/v0.22.12
 title: v0.22.12
-sidebar_position: 10
+sidebar_position: 11
 ---
 # metal-stack v0.22.12
 See original release note at [https://github.com/metal-stack/releases/releases/tag/v0.22.12](https://github.com/metal-stack/releases/releases/tag/v0.22.12)
diff --git a/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.13.md b/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.13.md
index 4898f56b..9c3fde29 100644
--- a/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.13.md	
+++ b/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.13.md	
@@ -1,7 +1,7 @@
 ---
 slug: /release-notes/v0.22.13
 title: v0.22.13
-sidebar_position: 9
+sidebar_position: 10
 ---
 # metal-stack v0.22.13
 See original release note at [https://github.com/metal-stack/releases/releases/tag/v0.22.13](https://github.com/metal-stack/releases/releases/tag/v0.22.13)
diff --git a/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.14.md b/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.14.md
index ee80f025..0b3e6082 100644
--- a/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.14.md	
+++ b/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.14.md	
@@ -1,7 +1,7 @@
 ---
 slug: /release-notes/v0.22.14
 title: v0.22.14
-sidebar_position: 8
+sidebar_position: 9
 ---
 # metal-stack v0.22.14
 See original release note at [https://github.com/metal-stack/releases/releases/tag/v0.22.14](https://github.com/metal-stack/releases/releases/tag/v0.22.14)
diff --git a/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.15.md b/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.15.md
index 37c16ece..62f731d0 100644
--- a/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.15.md	
+++ b/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.15.md	
@@ -1,7 +1,7 @@
 ---
 slug: /release-notes/v0.22.15
 title: v0.22.15
-sidebar_position: 7
+sidebar_position: 8
 ---
 # metal-stack v0.22.15
 See original release note at [https://github.com/metal-stack/releases/releases/tag/v0.22.15](https://github.com/metal-stack/releases/releases/tag/v0.22.15)
diff --git a/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.16.md b/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.16.md
index 7782a49f..18e40c84 100644
--- a/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.16.md	
+++ b/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.16.md	
@@ -1,7 +1,7 @@
 ---
 slug: /release-notes/v0.22.16
 title: v0.22.16
-sidebar_position: 6
+sidebar_position: 7
 ---
 # metal-stack v0.22.16
 See original release note at [https://github.com/metal-stack/releases/releases/tag/v0.22.16](https://github.com/metal-stack/releases/releases/tag/v0.22.16)
diff --git a/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.17.md b/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.17.md
index 27d900d3..2870437e 100644
--- a/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.17.md	
+++ b/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.17.md	
@@ -1,7 +1,7 @@
 ---
 slug: /release-notes/v0.22.17
 title: v0.22.17
-sidebar_position: 5
+sidebar_position: 6
 ---
 # metal-stack v0.22.17
 See original release note at [https://github.com/metal-stack/releases/releases/tag/v0.22.17](https://github.com/metal-stack/releases/releases/tag/v0.22.17)
diff --git a/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.18.md b/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.18.md
index c48d3f66..03cc9679 100644
--- a/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.18.md	
+++ b/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.18.md	
@@ -1,7 +1,7 @@
 ---
 slug: /release-notes/v0.22.18
 title: v0.22.18
-sidebar_position: 4
+sidebar_position: 5
 ---
 # metal-stack v0.22.18
 See original release note at [https://github.com/metal-stack/releases/releases/tag/v0.22.18](https://github.com/metal-stack/releases/releases/tag/v0.22.18)
diff --git a/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.19.md b/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.19.md
index f3821d0c..d9d9ec6b 100644
--- a/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.19.md	
+++ b/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.19.md	
@@ -1,7 +1,7 @@
 ---
 slug: /release-notes/v0.22.19
 title: v0.22.19
-sidebar_position: 3
+sidebar_position: 4
 ---
 # metal-stack v0.22.19
 See original release note at [https://github.com/metal-stack/releases/releases/tag/v0.22.19](https://github.com/metal-stack/releases/releases/tag/v0.22.19)
diff --git a/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.2.md b/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.2.md
index 6165d809..b64ea0c0 100644
--- a/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.2.md	
+++ b/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.2.md	
@@ -1,7 +1,7 @@
 ---
 slug: /release-notes/v0.22.2
 title: v0.22.2
-sidebar_position: 20
+sidebar_position: 21
 ---
 # metal-stack v0.22.2
 See original release note at [https://github.com/metal-stack/releases/releases/tag/v0.22.2](https://github.com/metal-stack/releases/releases/tag/v0.22.2)
diff --git a/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.20.md b/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.20.md
index cd27b04e..0ab0dbfa 100644
--- a/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.20.md	
+++ b/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.20.md	
@@ -1,7 +1,7 @@
 ---
 slug: /release-notes/v0.22.20
 title: v0.22.20
-sidebar_position: 2
+sidebar_position: 3
 ---
 # metal-stack v0.22.20
 See original release note at [https://github.com/metal-stack/releases/releases/tag/v0.22.20](https://github.com/metal-stack/releases/releases/tag/v0.22.20)
diff --git a/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.21.md b/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.21.md
index c39c49fb..0db1c4af 100644
--- a/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.21.md	
+++ b/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.21.md	
@@ -1,12 +1,13 @@
 ---
 slug: /release-notes/v0.22.21
 title: v0.22.21
-sidebar_position: 1
+sidebar_position: 2
 ---
 # metal-stack v0.22.21
 See original release note at [https://github.com/metal-stack/releases/releases/tag/v0.22.21](https://github.com/metal-stack/releases/releases/tag/v0.22.21)
 ## General
 * [Gardener v1.140](https://github.com/gardener/gardener/releases/tag/v1.140.0)
+* This release was integration tested against the control plane that fully uses Gateway API and without anymore Ingress resources. We recommend to migrate to Gateway API for this release.
 ## Noteworthy
 * Add environment variables support to cosign verify. (metal-stack/ansible-common#50)
 * Prometheus in the partition monitoring role can now be configured with additional labels. As some systems use `replica` while others use `__replica__` that may conflict, the label: `replica: '{{ inventory_hostname }}'` has been added to the defaults. If you make use of this configuration option and want to keep the `replica` label, make sure to include it explicitly. (metal-stack/metal-roles#702)
diff --git a/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.22.md b/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.22.md
new file mode 100644
index 00000000..6cd17a1e
--- /dev/null
+++ b/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.22.md	
@@ -0,0 +1,81 @@
+---
+slug: /release-notes/v0.22.22
+title: v0.22.22
+sidebar_position: 1
+---
+# metal-stack v0.22.22
+See original release note at [https://github.com/metal-stack/releases/releases/tag/v0.22.22](https://github.com/metal-stack/releases/releases/tag/v0.22.22)
+## General
+* [Gardener v1.141](https://github.com/gardener/gardener/releases/tag/v1.141.0)
+  - ⚠️ Gardener does no longer support Garden, Seed, or Shoot clusters with Kubernetes versions <= 1.30. Make sure to upgrade all existing clusters before upgrading to this Gardener version.
+* This release was integration tested against the control plane that fully uses Gateway API and without anymore Ingress resources. We recommend to migrate to Gateway API for this release.
+## Required Actions
+* The metal-image-cache-sync is the first component to be migrated to use the V2 metal-stack API by communicating with the metal-apiserver. To deploy it, please take care of the following tasks:
+  
+  - Add the role `metal-roles/common/roles/metal-v2-client` to your partition playbook to install the Python API V2 client into the deployment runner.
+  - Make sure the metal-apiserver is running in the control-plane. 
+  - Ensure that the new variables `defaults_partition_metal_apiserver_url` and `defaults_partition_metal_apiserver_admin_token` are provided through inventory. We advice to provide the partition deployment token by manually creating it through the metalctlv2 CLI and storing it ansible-vaulted in the inventory. Renewal cycles of this token are up to the deployment operator. (metal-stack/metal-roles#453)
+## Breaking Changes
+* The metal-image-cache-sync has been migrated to the metal-stack V2 API. This means that it is no longer possible to connect to the metal-api, but instead to the new metal-apiserver, which was introduced in an earlier release. Please check the metal-roles release notes and adapt your deployment accordingly. (metal-stack/metal-image-cache-sync#21)
+* The `metal_apiserver_session_secret` variable is now required. Make sure that it set in your deployment and has a length >= 10 characters. (metal-stack/metal-roles#725)
+* `dhcp_relay_src_intf` and `dhcp_relay_server_vrf` are no longer set automatically when `dhcp_servers` are defined but must be set explicitly. (metal-stack/sonic-configdb-utils#50)
+## Component Releases
+### gardener-extension-dns-powerdns v0.8.0
+* Fix RBACs for runtime clusters. (metal-stack/gardener-extension-dns-powerdns#16) @Gerrit91
+* Update README and actions. (metal-stack/gardener-extension-dns-powerdns#17) @Gerrit91
+### api v0.5.1
+* Make switch nic mac optional (metal-stack/api#182) @iljarotar
+* Machine BMC List must have MachineQuery instead of MachineBMCQuery (metal-stack/api#179) @majst01
+* PlacementLabels, and b64 encoded userdata (metal-stack/api#180) @majst01
+* If tokenfile instead of token is specified, no reread happens (metal-stack/api#178) @majst01
+* Fix js generate (metal-stack/api#177) @iljarotar
+* Fix punctuation in docstrings (metal-stack/api#175) @majst01
+* Add generic Typescript client (metal-stack/api#171) @majst01
+* Fix npm publish (metal-stack/api#183) @iljarotar
+### metal-apiserver v0.10.0
+* Allow nil mac for switch nics (metal-stack/metal-apiserver#287) @iljarotar
+* Update err msg to match check (metal-stack/metal-apiserver#284) @eberlep
+* Fix machine bmc list (metal-stack/metal-apiserver#285) @majst01
+* Adapt to latest API (placement labels + b64 userdata). (metal-stack/metal-apiserver#286) @Gerrit91
+* Update protovalidate (metal-stack/metal-apiserver#283) @majst01
+* Update deps, remove replaces (metal-stack/metal-apiserver#281) @majst01
+* Allow changing port status of unconnected ports (metal-stack/metal-apiserver#282) @iljarotar
+* Add image labels. (metal-stack/metal-apiserver#279) @Gerrit91
+### metal-image-cache-sync v0.2.0
+* Migrate to V2 API (metal-stack/metal-image-cache-sync#21) @majst01
+* Update actions workflows and dependencies. (metal-stack/metal-image-cache-sync#26) @Gerrit91
+* include sbom in container image (metal-stack/metal-image-cache-sync#20) @mac641
+* Migrate to golangci lint v2 and satisfy new warnings (metal-stack/metal-image-cache-sync#19) @majst01
+### sonic-configdb-utils v0.6.1
+* Allow adding src_intf and server_vrf to dhcp_relay (metal-stack/sonic-configdb-utils#45) @iljarotar
+* Allow adding additional numbered interfaces (metal-stack/sonic-configdb-utils#44) @iljarotar
+* Use substring matching for version checking for latest 202211 sonic version (metal-stack/sonic-configdb-utils#35) @mreiger
+* Dependabot mongo driver 1 17 7 (metal-stack/sonic-configdb-utils#49) @iljarotar
+* Cleanup vlan dhcp_relay (metal-stack/sonic-configdb-utils#48) @iljarotar
+* Dhcp relay src intf and server vrf (metal-stack/sonic-configdb-utils#47) @iljarotar
+### metal-roles v0.32.1
+* Migrate metal-image-cache-sync to V2 API (metal-stack/metal-roles#453) @majst01
+* Make `metal_apiserver_session_secret` required. (metal-stack/metal-roles#725) @Gerrit91
+* Add ansible variable to configure OIDC ID for metal-apiserver (metal-stack/metal-roles#718) @simcod, @Gerrit91
+* Add configuration options for auditing and valkey (metal-stack/metal-roles#701) @simcod
+* fix(isolated clusters):  add cilium to oci-mirror-config (metal-stack/metal-roles#735) @mwennrich
+* Refactor gardener-metrics-exporter and refresher configuration options (metal-stack/metal-roles#726) @simcod
+* Remove unused gardener ingress nginx variable. (metal-stack/metal-roles#727) @Gerrit91
+* Increase default token expiration for image-cache. (metal-stack/metal-roles#731) @Gerrit91
+### metal-token-refresher v0.1.0
+* refactor(tests): drop mocks in favor of interceptors (metal-stack/metal-token-refresher#5) @vknabel
+* Github actions permissions for dependabot. (metal-stack/metal-token-refresher#3) @Gerrit91
+* build(deps): bump github.com/metal-stack/api from 0.2.3 to 0.2.6 in the metal-stack group (metal-stack/metal-token-refresher#2) [@dependabot[bot]](https://github.com/apps/dependabot)
+* chore(ci): minimal permissions for spell-check workflow (metal-stack/metal-token-refresher#4) @vknabel
+# Merged Pull Requests
+This is a list of pull requests that were merged since the last release. The list does not contain pull requests from release-vector-repositories.
+
+The fact that these pull requests were merged does not necessarily imply that they have already become part of this metal-stack release.
+
+* Generic enum completion, switch os in list view (metal-stack/cli#54) @majst01
+* Adapt to API v0.5.0 (metal-stack/cli#55) @Gerrit91
+* Gardener 1.141.6 (metal-stack/releases#317) @vknabel
+* Bump releases to version v0.22.21 (metal-stack/website#345) @metal-robot[bot]
+* Update Ubuntu kernel to v6.18.44 (metal-stack/metal-images#439) @mwennrich
+* Go 1.27 (metal-stack/cli#57) @majst01
+* Next release (metal-stack/releases#316) @metal-robot[bot]
\ No newline at end of file
diff --git a/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.3.md b/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.3.md
index 1541ca9f..8c4802dd 100644
--- a/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.3.md	
+++ b/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.3.md	
@@ -1,7 +1,7 @@
 ---
 slug: /release-notes/v0.22.3
 title: v0.22.3
-sidebar_position: 19
+sidebar_position: 20
 ---
 # metal-stack v0.22.3
 See original release note at [https://github.com/metal-stack/releases/releases/tag/v0.22.3](https://github.com/metal-stack/releases/releases/tag/v0.22.3)
diff --git a/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.4.md b/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.4.md
index a500952d..a4e2038b 100644
--- a/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.4.md	
+++ b/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.4.md	
@@ -1,7 +1,7 @@
 ---
 slug: /release-notes/v0.22.4
 title: v0.22.4
-sidebar_position: 18
+sidebar_position: 19
 ---
 # metal-stack v0.22.4
 See original release note at [https://github.com/metal-stack/releases/releases/tag/v0.22.4](https://github.com/metal-stack/releases/releases/tag/v0.22.4)
diff --git a/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.5.md b/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.5.md
index cc6a807e..9c9c7d6f 100644
--- a/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.5.md	
+++ b/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.5.md	
@@ -1,7 +1,7 @@
 ---
 slug: /release-notes/v0.22.5
 title: v0.22.5
-sidebar_position: 17
+sidebar_position: 18
 ---
 # metal-stack v0.22.5
 See original release note at [https://github.com/metal-stack/releases/releases/tag/v0.22.5](https://github.com/metal-stack/releases/releases/tag/v0.22.5)
diff --git a/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.6.md b/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.6.md
index 3a87d147..0a70bceb 100644
--- a/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.6.md	
+++ b/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.6.md	
@@ -1,7 +1,7 @@
 ---
 slug: /release-notes/v0.22.6
 title: v0.22.6
-sidebar_position: 16
+sidebar_position: 17
 ---
 # metal-stack v0.22.6
 See original release note at [https://github.com/metal-stack/releases/releases/tag/v0.22.6](https://github.com/metal-stack/releases/releases/tag/v0.22.6)
diff --git a/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.7.md b/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.7.md
index babf9aa3..003f797d 100644
--- a/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.7.md	
+++ b/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.7.md	
@@ -1,7 +1,7 @@
 ---
 slug: /release-notes/v0.22.7
 title: v0.22.7
-sidebar_position: 15
+sidebar_position: 16
 ---
 # metal-stack v0.22.7
 See original release note at [https://github.com/metal-stack/releases/releases/tag/v0.22.7](https://github.com/metal-stack/releases/releases/tag/v0.22.7)
diff --git a/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.8.md b/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.8.md
index 420dae1b..b57000a4 100644
--- a/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.8.md	
+++ b/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.8.md	
@@ -1,7 +1,7 @@
 ---
 slug: /release-notes/v0.22.8
 title: v0.22.8
-sidebar_position: 14
+sidebar_position: 15
 ---
 # metal-stack v0.22.8
 See original release note at [https://github.com/metal-stack/releases/releases/tag/v0.22.8](https://github.com/metal-stack/releases/releases/tag/v0.22.8)
diff --git a/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.9.md b/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.9.md
index c783a42a..eccf7d2b 100644
--- a/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.9.md	
+++ b/versioned_docs/version-v0.22/07-Release Notes/v0.22/v0.22.9.md	
@@ -1,7 +1,7 @@
 ---
 slug: /release-notes/v0.22.9
 title: v0.22.9
-sidebar_position: 13
+sidebar_position: 14
 ---
 # metal-stack v0.22.9
 See original release note at [https://github.com/metal-stack/releases/releases/tag/v0.22.9](https://github.com/metal-stack/releases/releases/tag/v0.22.9)
diff --git a/versioned_docs/version-v0.22/08-References/Gardener/os-metal-extension/os-metal-extension.md b/versioned_docs/version-v0.22/08-References/Gardener/os-metal-extension/os-metal-extension.md
index 38706cfc..8eb63d06 100644
--- a/versioned_docs/version-v0.22/08-References/Gardener/os-metal-extension/os-metal-extension.md
+++ b/versioned_docs/version-v0.22/08-References/Gardener/os-metal-extension/os-metal-extension.md
@@ -6,6 +6,26 @@ sidebar_position: 5
 
 # os-metal-extension
 
-This extension provides controllers to reconcile `OperatingSystemConfig`s and transforms them into [Ignition](https://www.flatcar.org/docs/latest/provisioning/ignition/) userdata. This userdata can be applied during machine provisioning as done by the metal-stack project.
+[![GitHub License](https://img.shields.io/github/license/metal-stack/os-metal-extension)](https://github.com/metal-stack/os-metal-extension/blob/master/LICENCE)
+[![Build](https://github.com/metal-stack/os-metal-extension/actions/workflows/build.yaml/badge.svg)](https://github.com/metal-stack/os-metal-extension/actions/workflows/build.yaml)
+
+This controller operates on the [`OperatingSystemConfig`](https://github.com/gardener/gardener/blob/master/docs/proposals/01-extensibility.md#cloud-config-user-data-for-bootstrapping-machines) resource in the `extensions.gardener.cloud/v1alpha1` API group. It manages those objects that are requesting:
+
+- [Ubuntu](https://www.ubuntu.com/) configuration (`.spec.type=ubuntu`)
+- [Debian](https://www.debian.org/) configuration (`.spec.type=debian`)
+
+In comparison to the official OSC extensions from Gardener, this extension transforms the `OperatingSystemConfig` resources into [Ignition](https://www.flatcar.org/docs/latest/provisioning/ignition/) userdata. This userdata can be applied during machine provisioning as done by the metal-stack project.
 
 This extension was made for working with operating system images built in the [metal-images](https://github.com/metal-stack/metal-images) repository.
+
+## Example
+
+An example `ControllerRegistration` resource that can be used to register this controller to Gardener can be found [here](example/controller-registration.yaml).
+
+## Development
+
+Development currently needs to happen against a real environment because there are many dependencies to external APIs for reconciliation. It is planned to allow development in the [mini-lab](https://github.com/metal-stack/mini-lab) soon.
+
+## Feedback and Support
+
+Feedback and contributions are always welcome! Please report bugs or suggestions as [GitHub issues](https://github.com/metal-stack/os-metal-extension/issues) or reach out to our [community](https://metal-stack.io/community).