diff --git a/docs/ru/language-snippets.ent b/docs/ru/language-snippets.ent
index e69de29b..54b0614e 100644
--- a/docs/ru/language-snippets.ent
+++ b/docs/ru/language-snippets.ent
@@ -0,0 +1,24 @@
+<!ENTITY note.parameter.merge '<note>
+ <title>Техническое замечание</title>
+ <para>
+  Пераметр <parameter>merge</parameter> принимает ключи в виде массива,
+  поэтому если вы объединяете массивы с числовыми индексами, то они могут 
+  наложиться друг на друга или в результате может получиться массив с 
+  пропущенными ключами. Заметьте, что в отличие от этого, функция PHP
+  array_merge() перенумеровывает совпадающие числовые индексы.
+ </para>
+</note>'>
+
+<!ENTITY parameter.compileid '<para>
+ В качестве необязательного третьего параметра вы можете передать
+ <parameter>compile_id</parameter>. Это указывает на то, что вы хотите
+ иметь несколько разных версий одного и того же скомпилированного шаблона, 
+ например, для разных яызков. Другой вариант применения 
+ <parameter>compile_id</parameter> - это когда у вас есть несколько 
+ директорий с шаблонами ($template_dir), но только одна директория с
+ компилированными шаблонами ($compile_dir). Установите отдельный 
+ <parameter>compile_id</parameter> для каждой $template_dir, иначе 
+ одноименные шаблоны из разных директорий будут перезаписывать друг друга.
+ Вы также можете указать <link linkend="variable.compile.id">$compile_id</link> 
+ один раз вместо того, чтобы каждый раз передавать его этой функции.
+</para>'>