diff --git a/spring-shell-docs/src/main/asciidoc/using-shell-components-ui.adoc b/spring-shell-docs/src/main/asciidoc/using-shell-components-ui.adoc
index 46182258..4e4c653f 100644
--- a/spring-shell-docs/src/main/asciidoc/using-shell-components-ui.adoc
+++ b/spring-shell-docs/src/main/asciidoc/using-shell-components-ui.adoc
@@ -18,6 +18,12 @@ Build-in components generally follow logic:
 * Exit
 * Render final status of a component state
 
+[NOTE]
+====
+<<using-shell-components-flow>> gives better interface defining flow of a
+components which better suited for defining interactive command flows.
+====
+
 ===== Component Render
 
 There are two ways to implement component rendering, firstly fully