diff --git a/doc/assumptions.txt b/doc/assumptions.txt
index 396d3ffd..30a0375f 100644
--- a/doc/assumptions.txt
+++ b/doc/assumptions.txt
@@ -1,3 +1,5 @@
+предположения фрагментов кода об окружении
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 - pkg.in/lists/Makefile
   + ожидает, что названия пакаджлистов указываются в переменных
     вида *_LISTS, и копирует в генерируемый профиль только их
diff --git a/doc/debug.txt b/doc/debug.txt
index e4c9eef1..78f12fe6 100644
--- a/doc/debug.txt
+++ b/doc/debug.txt
@@ -1,3 +1,5 @@
+ловля плюх
+~~~~~~~~~~
 При отладке сборки конфигурации или самого дистрибутива
 могут оказаться полезными следующие средства:
 
diff --git a/doc/features.txt b/doc/features.txt
index 42d2a536..6d349337 100644
--- a/doc/features.txt
+++ b/doc/features.txt
@@ -1,3 +1,5 @@
+фичи
+~~~~
 Особенности дистрибутива, не учитываемые в пакетной базе
 или зависящие от переменных времени сборки/установки образа,
 могут быть оформлены несколькими образами:
@@ -18,7 +20,9 @@
 * необходимы пакетные зависимости;
 * требуется компилируемый платформозависимый код (для чего бы...);
 * код фичи достаточно специфичен, нетривиален и объёмен,
-  чтобы загромождать метапрофиль было не очень осмысленно.
+  чтобы загромождать метапрофиль было не очень осмысленно;
+* фича представляет из себя отдельный мини-продукт, над которым
+  ведётся активная работа (возможно, несколькими людьми).
 
 Стоит избегать изменения пакетных умолчаний в случае, когда их
 представляется осмысленным и возможным скорректировать в пакете:
diff --git a/doc/variables.txt b/doc/variables.txt
index e1bd800c..62c264ae 100644
--- a/doc/variables.txt
+++ b/doc/variables.txt
@@ -1,3 +1,5 @@
+переменные make
+~~~~~~~~~~~~~~~
 При запуске на сборку принимается ряд переменных
 (см. тж. profiles.mk.sample):
 
@@ -27,3 +29,7 @@
   + включение средств отладки
   + значение: пусто (по умолчанию), 1 или 2
   + см. log.mk
+
+пример
+~~~~~~
+make DEBUG=1 CLEAN=1 syslinux.iso