From dbebbcaddda6e6693c4c04fa57a74ef69a0b6046 Mon Sep 17 00:00:00 2001
From: Andreas Kupries <akupries@suse.com>
Date: Thu, 26 Jun 2025 14:57:09 +0200
Subject: [PATCH] Apply suggestions from code review

Co-authored-by: Peter Matseykanets <pmatseykanets@gmail.com>
---
 docs/api/workflows/tokens.md | 13 +++----------
 1 file changed, 3 insertions(+), 10 deletions(-)

diff --git a/docs/api/workflows/tokens.md b/docs/api/workflows/tokens.md
index e2957dd56a2..cd8d04b6827 100644
--- a/docs/api/workflows/tokens.md
+++ b/docs/api/workflows/tokens.md
@@ -37,7 +37,7 @@ The `spec.kind` field can be set to the kind of token.
 The value "session" indicates a login token.
 All other kinds, including the default (empty string) indicate some kind of derived token.
 
-The `name` and `generateName` fields of the new token are ignored. The system automatically chooses a name using the prefix `token-`.
+The `metadata.name` and `metadata.generateName` fields are ignored and the name of the new Token is automatically generated using the prefix `token-`.
 
 ```bash
 kubectl create -o jsonpath='{.status.value}' -f -<<EOF
@@ -118,14 +118,7 @@ Only the metadata, the `spec.description` field, the `spec.ttl` field, and the `
 All other `spec` fields are immutable.
 Admins are able to extend the `spec.ttl` field, while regular users can only reduce the value.
 
-To add a label to a Token:
+To edit a Token:
 
 ```sh
-kubectl patch token token-zp786 -p '{"metadata":{"labels":{"foo":"bar"}}}'
-```
-
-To change the description of a Token:
-
-```sh
-kubectl patch token token-zp786 -p '{"spec":{"description":"Updated description"}}'
-```
+kubectl edit tokens.ext.cattle.io token-zp786