diff --git a/docs/source/glossary.rst b/docs/source/glossary.rst
index ebbea080..1af1c3cb 100644
--- a/docs/source/glossary.rst
+++ b/docs/source/glossary.rst
@@ -61,6 +61,19 @@ Tag
 Used to create arbitrary groups of resources, later this groups will be
 used for different user operations.
 
+
+Basic resource structure
+------------------------
+
+.. code::
+
+   ├── actions
+   │   ├── remove.pp
+   │   ├── run.pp
+   │   └── update.pp
+   └── meta.yaml
+
+
 .. _res-handler-term:
 
 Handler
@@ -72,6 +85,14 @@ actions ::
 
   handler: puppet
 
+
+There are 2 special directories:
+
+- ``templates``
+- ``scripts``
+
+if found, these directories with all contents will be synchronized to remote host by sync :ref:`res-transports-term`.
+
 .. _res-transports-term:
 
 Transport
@@ -102,6 +123,7 @@ BAT transport
 According to preferences solar will choose best available transport for
 file uploading and command execution.
 
+
 .. _res-event-term:
 
 Event