From 7b59c810d95b46fd0a0b097a4f7031d8e274820e Mon Sep 17 00:00:00 2001
From: Esko Dijk <EskoDijk@users.noreply.github.com>
Date: Fri, 22 Aug 2025 22:05:00 +0200
Subject: [PATCH] [cli] clarify and improve TCAT CLI README, including links to
 relevant ID types (#11832)

---
 src/cli/README_TCAT.md | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/src/cli/README_TCAT.md b/src/cli/README_TCAT.md
index dafa74135..77dc9ba38 100644
--- a/src/cli/README_TCAT.md
+++ b/src/cli/README_TCAT.md
@@ -10,7 +10,7 @@
 
 ### advid
 
-Displays currently set TCAT advertised ids.
+Displays currently set TCAT advertised IDs.
 
 ```bash
 tcat advid
@@ -20,7 +20,7 @@ Done
 
 ### advid ianapen \<id\>
 
-Sets TCAT advertised ianapen id.
+Sets TCAT advertised IANA PEN (Private Enterprise Number) ID. See the [IANA PEN registry](https://www.iana.org/assignments/enterprise-numbers/).
 
 ```bash
 tcat advid ianapen f378aabb
@@ -29,7 +29,7 @@ Done
 
 ### advid oui24 \<id\>
 
-Sets TCAT advertised oui24 id.
+Sets TCAT advertised IEEE OUI-24 ID. See the [IEEE OUI registry](https://standards.ieee.org/products-programs/regauth/oui/).
 
 ```bash
 tcat advid oui24 f378aa
@@ -38,7 +38,7 @@ Done
 
 ### advid oui36 \<id\>
 
-Sets TCAT advertised oui36 id.
+Sets TCAT advertised IEEE OUI-36 ID. See the [IEEE OUI registry](https://standards.ieee.org/products-programs/regauth/oui/).
 
 ```bash
 tcat advid oui36 f378aabbcc
@@ -47,7 +47,7 @@ Done
 
 ### advid discriminator \<id\>
 
-Sets TCAT advertised discriminator id.
+Sets TCAT advertised device discriminator ID.
 
 ```bash
 tcat advid discriminator f378aabbdd
@@ -56,7 +56,7 @@ Done
 
 ### advid clear
 
-Clears TCAT advertised id.
+Clears all TCAT advertised IDs.
 
 ```bash
 tcat advid clear
@@ -84,7 +84,7 @@ Done
 
 ### devid
 
-Displays currently set TCAT device id.
+Displays currently set TCAT Device ID. This ID is unique for the TCAT Device and is ecosystem- or vendor-specific.
 
 ```bash
 tcat devid
@@ -94,7 +94,7 @@ Done
 
 ### devid \<id\>
 
-Sets TCAT device id.
+Sets TCAT Device ID. The format of \<id\> is a hex string encoding the binary ID.
 
 ```bash
 tcat devid abcd
@@ -103,7 +103,7 @@ Done
 
 ### devid clear
 
-Clears TCAT device id.
+Clears TCAT Device ID.
 
 ```bash
 tcat devid clear
@@ -112,7 +112,7 @@ Done
 
 ### help
 
-print help
+Print help.
 
 ```bash
 tcat help