From 937100578fac1e6eede75d7265d665f21b634c44 Mon Sep 17 00:00:00 2001
From: Ian <48763937+inichols@users.noreply.github.com>
Date: Thu, 10 Oct 2024 12:23:48 -0400
Subject: [PATCH 1/2] Add manage-namespaces documentation

https://github.com/rancher/webhook/blob/release/v0.4/docs.md#project-annotation
---
 docs/reference-guides/rancher-webhook.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/reference-guides/rancher-webhook.md b/docs/reference-guides/rancher-webhook.md
index 39223b92d4e..12943ba186e 100644
--- a/docs/reference-guides/rancher-webhook.md
+++ b/docs/reference-guides/rancher-webhook.md
@@ -126,6 +126,8 @@ The webhook provides extra validations on [namespaces](https://github.com/ranche
 - A user account with the proper permissions can pre-create the namespace with the appropriate configuration.
   - This option depends on the ability of the application to handle existing resources.
 
+Another one of these validations ensures that the user has the proper permissions to update the `field.cattle.io/projectId` annotation on a namespace. These permissions would be `manage-namespaces` for `projects` in `management.cattle.io`
+
 ## Issues on Specific Versions
 
 **Note:** The following is an incomplete list of high-severity issues affecting specific Rancher/webhook versions. In most cases, these issues can be resolved by upgrading to a more recent Rancher version.

From 277b5809824120fb452279238a8d58f21ee522e5 Mon Sep 17 00:00:00 2001
From: Billy Tat <btat@suse.com>
Date: Tue, 15 Oct 2024 13:53:49 -0700
Subject: [PATCH 2/2] Port 93710057 (Add manage-namespaces documentation) to
 other en/zh 2.7-2.9

---
 docs/reference-guides/rancher-webhook.md                        | 2 +-
 .../current/reference-guides/rancher-webhook.md                 | 2 ++
 .../version-2.7/reference-guides/rancher-webhook.md             | 2 ++
 .../version-2.8/reference-guides/rancher-webhook.md             | 2 ++
 .../version-2.9/reference-guides/rancher-webhook.md             | 2 ++
 versioned_docs/version-2.7/reference-guides/rancher-webhook.md  | 2 ++
 versioned_docs/version-2.8/reference-guides/rancher-webhook.md  | 2 ++
 versioned_docs/version-2.9/reference-guides/rancher-webhook.md  | 2 ++
 8 files changed, 15 insertions(+), 1 deletion(-)

diff --git a/docs/reference-guides/rancher-webhook.md b/docs/reference-guides/rancher-webhook.md
index 12943ba186e..8a8a3a811df 100644
--- a/docs/reference-guides/rancher-webhook.md
+++ b/docs/reference-guides/rancher-webhook.md
@@ -126,7 +126,7 @@ The webhook provides extra validations on [namespaces](https://github.com/ranche
 - A user account with the proper permissions can pre-create the namespace with the appropriate configuration.
   - This option depends on the ability of the application to handle existing resources.
 
-Another one of these validations ensures that the user has the proper permissions to update the `field.cattle.io/projectId` annotation on a namespace. These permissions would be `manage-namespaces` for `projects` in `management.cattle.io`
+Another one of these validations ensures that the user has the proper permissions to update the `field.cattle.io/projectId` annotation on a namespace. This is the `manage-namespaces` permission for `projects` in `management.cattle.io`.
 
 ## Issues on Specific Versions
 
diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/reference-guides/rancher-webhook.md b/i18n/zh/docusaurus-plugin-content-docs/current/reference-guides/rancher-webhook.md
index e8a77888233..90a7c4b3e6b 100644
--- a/i18n/zh/docusaurus-plugin-content-docs/current/reference-guides/rancher-webhook.md
+++ b/i18n/zh/docusaurus-plugin-content-docs/current/reference-guides/rancher-webhook.md
@@ -120,6 +120,8 @@ webhook 在 [namespaces](https://github.com/rancher/webhook/blob/release/v0.4/do
 - 具有适当权限的用户帐户可以使用适当的配置预先创建命名空间。
   - 此选项取决于应用程序处理现有资源的能力。
 
+Another one of these validations ensures that the user has the proper permissions to update the `field.cattle.io/projectId` annotation on a namespace. This is the `manage-namespaces` permission for `projects` in `management.cattle.io`.
+
 ## 特定版本的问题
 
 **注意：** 以下是影响特定 Rancher/webhook 版本的高严重性问题的不完整列表。在大多数情况下，这些问题可以通过升级到更新的 Rancher 版本来解决。
diff --git a/i18n/zh/docusaurus-plugin-content-docs/version-2.7/reference-guides/rancher-webhook.md b/i18n/zh/docusaurus-plugin-content-docs/version-2.7/reference-guides/rancher-webhook.md
index ee0852497c6..3d6bb84a4ef 100644
--- a/i18n/zh/docusaurus-plugin-content-docs/version-2.7/reference-guides/rancher-webhook.md
+++ b/i18n/zh/docusaurus-plugin-content-docs/version-2.7/reference-guides/rancher-webhook.md
@@ -129,6 +129,8 @@ webhook 在 [namespaces](https://github.com/rancher/webhook/blob/release/v0.4/do
 - 具有适当权限的用户帐户可以使用适当的配置预先创建命名空间。
   - 此选项取决于应用程序处理现有资源的能力。
 
+Another one of these validations ensures that the user has the proper permissions to update the `field.cattle.io/projectId` annotation on a namespace. This is the `manage-namespaces` permission for `projects` in `management.cattle.io`.
+
 ## 特定版本的问题
 
 **注意：** 以下是影响特定 Rancher/webhook 版本的高严重性问题的不完整列表。在大多数情况下，这些问题可以通过升级到更新的 Rancher 版本来解决。
diff --git a/i18n/zh/docusaurus-plugin-content-docs/version-2.8/reference-guides/rancher-webhook.md b/i18n/zh/docusaurus-plugin-content-docs/version-2.8/reference-guides/rancher-webhook.md
index e8a77888233..90a7c4b3e6b 100644
--- a/i18n/zh/docusaurus-plugin-content-docs/version-2.8/reference-guides/rancher-webhook.md
+++ b/i18n/zh/docusaurus-plugin-content-docs/version-2.8/reference-guides/rancher-webhook.md
@@ -120,6 +120,8 @@ webhook 在 [namespaces](https://github.com/rancher/webhook/blob/release/v0.4/do
 - 具有适当权限的用户帐户可以使用适当的配置预先创建命名空间。
   - 此选项取决于应用程序处理现有资源的能力。
 
+Another one of these validations ensures that the user has the proper permissions to update the `field.cattle.io/projectId` annotation on a namespace. This is the `manage-namespaces` permission for `projects` in `management.cattle.io`.
+
 ## 特定版本的问题
 
 **注意：** 以下是影响特定 Rancher/webhook 版本的高严重性问题的不完整列表。在大多数情况下，这些问题可以通过升级到更新的 Rancher 版本来解决。
diff --git a/i18n/zh/docusaurus-plugin-content-docs/version-2.9/reference-guides/rancher-webhook.md b/i18n/zh/docusaurus-plugin-content-docs/version-2.9/reference-guides/rancher-webhook.md
index e8a77888233..90a7c4b3e6b 100644
--- a/i18n/zh/docusaurus-plugin-content-docs/version-2.9/reference-guides/rancher-webhook.md
+++ b/i18n/zh/docusaurus-plugin-content-docs/version-2.9/reference-guides/rancher-webhook.md
@@ -120,6 +120,8 @@ webhook 在 [namespaces](https://github.com/rancher/webhook/blob/release/v0.4/do
 - 具有适当权限的用户帐户可以使用适当的配置预先创建命名空间。
   - 此选项取决于应用程序处理现有资源的能力。
 
+Another one of these validations ensures that the user has the proper permissions to update the `field.cattle.io/projectId` annotation on a namespace. This is the `manage-namespaces` permission for `projects` in `management.cattle.io`.
+
 ## 特定版本的问题
 
 **注意：** 以下是影响特定 Rancher/webhook 版本的高严重性问题的不完整列表。在大多数情况下，这些问题可以通过升级到更新的 Rancher 版本来解决。
diff --git a/versioned_docs/version-2.7/reference-guides/rancher-webhook.md b/versioned_docs/version-2.7/reference-guides/rancher-webhook.md
index 40599609608..7bb7277c68b 100644
--- a/versioned_docs/version-2.7/reference-guides/rancher-webhook.md
+++ b/versioned_docs/version-2.7/reference-guides/rancher-webhook.md
@@ -131,6 +131,8 @@ The webhook provides extra validations on [namespaces](https://github.com/ranche
 - A user account with the proper permissions can pre-create the namespace with the appropriate configuration.
   - This option depends on the ability of the application to handle existing resources.
 
+Another one of these validations ensures that the user has the proper permissions to update the `field.cattle.io/projectId` annotation on a namespace. This is the `manage-namespaces` permission for `projects` in `management.cattle.io`.
+
 ## Issues on Specific Versions
 
 **Note:** The following is an incomplete list of high-severity issues affecting specific Rancher/webhook versions. In most cases, these issues can be resolved by upgrading to a more recent Rancher version.
diff --git a/versioned_docs/version-2.8/reference-guides/rancher-webhook.md b/versioned_docs/version-2.8/reference-guides/rancher-webhook.md
index a6c79864ef3..555ca704e42 100644
--- a/versioned_docs/version-2.8/reference-guides/rancher-webhook.md
+++ b/versioned_docs/version-2.8/reference-guides/rancher-webhook.md
@@ -124,6 +124,8 @@ The webhook provides extra validations on [namespaces](https://github.com/ranche
 - A user account with the proper permissions can pre-create the namespace with the appropriate configuration.
   - This option depends on the ability of the application to handle existing resources.
 
+Another one of these validations ensures that the user has the proper permissions to update the `field.cattle.io/projectId` annotation on a namespace. This is the `manage-namespaces` permission for `projects` in `management.cattle.io`.
+
 ## Issues on Specific Versions
 
 **Note:** The following is an incomplete list of high-severity issues affecting specific Rancher/webhook versions. In most cases, these issues can be resolved by upgrading to a more recent Rancher version.
diff --git a/versioned_docs/version-2.9/reference-guides/rancher-webhook.md b/versioned_docs/version-2.9/reference-guides/rancher-webhook.md
index 39223b92d4e..8a8a3a811df 100644
--- a/versioned_docs/version-2.9/reference-guides/rancher-webhook.md
+++ b/versioned_docs/version-2.9/reference-guides/rancher-webhook.md
@@ -126,6 +126,8 @@ The webhook provides extra validations on [namespaces](https://github.com/ranche
 - A user account with the proper permissions can pre-create the namespace with the appropriate configuration.
   - This option depends on the ability of the application to handle existing resources.
 
+Another one of these validations ensures that the user has the proper permissions to update the `field.cattle.io/projectId` annotation on a namespace. This is the `manage-namespaces` permission for `projects` in `management.cattle.io`.
+
 ## Issues on Specific Versions
 
 **Note:** The following is an incomplete list of high-severity issues affecting specific Rancher/webhook versions. In most cases, these issues can be resolved by upgrading to a more recent Rancher version.