diff --git a/src/widget/widget.h b/src/widget/widget.h
index 0b3b2fd..658fa60 100644
--- a/src/widget/widget.h
+++ b/src/widget/widget.h
@@ -1,6 +1,11 @@
 /* SPDX-License-Identifier: MIT */
 /* Copyright (c) 2026 Oleksandr Zhylin */
 
+/* Header collector. 
+   It exports all the header files from this directory. 
+   Just include <widget.h> in the file in order to use all functionality 
+   given by this directory. */
+
 #ifndef WIDGET_H
 #define WIDGET_H
 #include "app.h"
diff --git a/src/widget_core/widget_core.c b/src/widget_core/widget_core.c
index cc874d5..126fe16 100644
--- a/src/widget_core/widget_core.c
+++ b/src/widget_core/widget_core.c
@@ -1,6 +1,10 @@
 /* SPDX-License-Identifier: MIT */
 /* Copyright (c) 2026 Oleksandr Zhylin */
 
+/* WidgetCore is a base for all widgets.
+  It is used by widgets themselves and some core components,
+  so it is separated from the widget directory */
+
 #include "widget_core.h"
 #include "../main.h"
 #include <ncursesw/ncurses.h>