From a2c69759468092758e36f47e7bd83c26e32f5e50 Mon Sep 17 00:00:00 2001
From: Paolo Dettori <dettori@us.ibm.com>
Date: Wed, 1 May 2024 10:27:21 -0500
Subject: [PATCH] add clarification on PCH behavior

Signed-off-by: Paolo Dettori <dettori@us.ibm.com>
---
 docs/users.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/users.md b/docs/users.md
index 47d693f..d391b3f 100644
--- a/docs/users.md
+++ b/docs/users.md
@@ -579,6 +579,10 @@ With kflex CLI (you can use --postcreate-hook or -p):
 kflex create cp1 --postcreate-hook <my-hook-name> # e.g. kflex create cp1 -p hello
 ```
 
+While `kflex create` waits for the control plane to be available, it does not guarantee 
+the hook's completion. Use `kubectl` commands to verify the status of resources created 
+by the hook.
+
 If you are using directly a ControlPlane CRD with kubectl, you can create a control plane
 with the post-create hook as in the following example: