From 75432346de09bd926ba2881ca8cfb7a84ffbd58f Mon Sep 17 00:00:00 2001
From: Georgii Surkov <georgii.surkov@outlook.com>
Date: Tue, 12 Mar 2024 19:54:45 +0300
Subject: [PATCH] Improve documentation

---
 applications/services/gui/view_dispatcher.h | 4 +++-
 applications/services/gui/view_holder.h     | 6 ++++++
 applications/services/gui/view_stack.h      | 4 +++-
 3 files changed, 12 insertions(+), 2 deletions(-)

diff --git a/applications/services/gui/view_dispatcher.h b/applications/services/gui/view_dispatcher.h
index 67a3fc40b..bec15f6e3 100644
--- a/applications/services/gui/view_dispatcher.h
+++ b/applications/services/gui/view_dispatcher.h
@@ -1,6 +1,8 @@
 /**
  * @file view_dispatcher.h
- * GUI: ViewDispatcher API
+ * @brief GUI: ViewDispatcher API
+ *
+ * @warning Views added to a ViewDispatcher MUST NOT be in a ViewStack at the same time.
  */
 
 #pragma once
diff --git a/applications/services/gui/view_holder.h b/applications/services/gui/view_holder.h
index 8e7db3b85..0bd29652c 100644
--- a/applications/services/gui/view_holder.h
+++ b/applications/services/gui/view_holder.h
@@ -1,3 +1,9 @@
+/**
+ * @file view_holder.h
+ * @brief GUI: ViewHolder API
+ *
+ * @warning View added to a ViewHolder MUST NOT be in a ViewStack at the same time.
+ */
 #pragma once
 
 #include <gui/view.h>
diff --git a/applications/services/gui/view_stack.h b/applications/services/gui/view_stack.h
index ed17f682f..7387038b0 100644
--- a/applications/services/gui/view_stack.h
+++ b/applications/services/gui/view_stack.h
@@ -1,11 +1,13 @@
 /**
  * @file view_stack.h
- * GUI: ViewStack API
+ * @brief GUI: ViewStack API
  *
  * ViewStack accumulates several Views in one stack.
  * Draw callbacks are called sequenctially starting from
  * first added. Input callbacks are called in reverse order.
  * Consumed input is not passed on underlying layers.
+ *
+ * @warning Views added to a ViewStack MUST NOT be in a ViewDispatcher or a ViewHolder at the same time.
  */
 
 #pragma once