From ef19e6525d0abacb1d7241bf9fe64fd24a814421 Mon Sep 17 00:00:00 2001
From: Marty Hernandez Avedon <marty.avedon@suse.com>
Date: Mon, 11 Mar 2024 10:15:29 -0400
Subject: [PATCH] #1153 update rancher kubernetes api project creation workflow
 doc to include annotation requirement for cluster member (#1167)

* Update Rancher Kubernetes API Project creation workflow doc to include annotation requirement for Cluster Member

* revised note

* revised wording
---
 docs/api/workflows/projects.md                | 20 +++++++++++++++++++
 .../version-2.8/api/workflows/projects.md     | 20 +++++++++++++++++++
 2 files changed, 40 insertions(+)

diff --git a/docs/api/workflows/projects.md b/docs/api/workflows/projects.md
index 549ceff5423..ea4b6fe66f3 100644
--- a/docs/api/workflows/projects.md
+++ b/docs/api/workflows/projects.md
@@ -29,6 +29,26 @@ Use `metadata.generateName` to ensure a unique project ID, but note that `kubect
 
 Set `metadata.namespace` and `spec.clusterName` to the ID for the cluster the project belongs to.
 
+If you create a project through a cluster member account, you must include the annotation, `field.cattle.io/creatorId`, and set it to the cluster member account's user ID.
+
+```bash
+kubectl create -f - <<EOF
+apiVersion: management.cattle.io/v3
+kind: Project
+metadata:
+  annotations: 
+  field.cattle.io/creatorId:
+    user-id
+  generateName: p-
+  namespace: c-m-abcde
+spec:
+  clusterName: c-m-abcde
+  displayName: myproject
+EOF
+```
+
+Setting the `field.cattle.io/creatorId` field allows the cluster member account to see project resources with the `get` command and view the project in the Rancher UI. Cluster owner and admin accounts don't need to set this annotation to perform these tasks.
+
 ### Creating a Project With a Resource Quota
 
 Refer to [Kubernetes Resource Quota](https://kubernetes.io/docs/concepts/policy/resource-quotas/).
diff --git a/versioned_docs/version-2.8/api/workflows/projects.md b/versioned_docs/version-2.8/api/workflows/projects.md
index b6f9a3b1d8b..33c6f27c4b4 100644
--- a/versioned_docs/version-2.8/api/workflows/projects.md
+++ b/versioned_docs/version-2.8/api/workflows/projects.md
@@ -29,6 +29,26 @@ Use `metadata.generateName` to ensure a unique project ID, but note that `kubect
 
 Set `metadata.namespace` and `spec.clusterName` to the ID for the cluster the project belongs to.
 
+If you create a project through a cluster member account, you must include the annotation, `field.cattle.io/creatorId`, and set it to the cluster member account's user ID.
+
+```bash
+kubectl create -f - <<EOF
+apiVersion: management.cattle.io/v3
+kind: Project
+metadata:
+  annotations: 
+  field.cattle.io/creatorId:
+    user-id
+  generateName: p-
+  namespace: c-m-abcde
+spec:
+  clusterName: c-m-abcde
+  displayName: myproject
+EOF
+```
+
+Setting the `field.cattle.io/creatorId` field allows the cluster member account to see project resources with the `get` command and view the project in the Rancher UI. Cluster owner and admin accounts don't need to set this annotation to perform these tasks.
+
 ### Creating a Project With a Resource Quota
 
 Refer to [Kubernetes Resource Quota](https://kubernetes.io/docs/concepts/policy/resource-quotas/).