diff --git a/docs/manual.md b/docs/manual.md
index 3fc1e1d..fa7d933 100644
--- a/docs/manual.md
+++ b/docs/manual.md
@@ -2368,12 +2368,15 @@ function payload_check(desync, def)
 берущих ctx. Чтобы корректно работали вложенные оркестраторы, нужно придерживаться стандартной схемы хранения execution plan в desync.plan
 и пользоваться описанными ниже функциями-хелперами.
 
+По сухому описанию может быть сложно понять как работает оркестрация. Рекомендуется изучить код реальных оркестраторов,
+а описанием пользоваться для уточнения смысла отдельных действий.
+
 ```
 function instance_cutoff_shim(ctx, desync, dir)
 ```
 
 Выполняет обычный instance cutoff по направлению dir, если ctx присутствует, иначе cutoff через дублирующий механизм,
-состояние которого хранится в desync.track.lua_state.
+состояние которого хранится в desync.track.lua_state. dir = true - исходящее направление, dir = false - входящее, dir = nil - оба направления.
 
 ```
 function cutoff_shim_check(desync)