diff --git a/docs/reference/cli.md b/docs/reference/cli.md
index 5808ce691f0e84789f2c54a0b70cc4a84725eb14..79f6a9e508647e701d4f94e3e275d7f7e1fe5599 100644
--- a/docs/reference/cli.md
+++ b/docs/reference/cli.md
@@ -216,6 +216,11 @@ picodata run -c instance.log.level=verbose -c instance.instance_dir=/path/to/dir
 
 Имя инстанса. При отсутствии параметра значение будет автоматически
 сгенерировано raft-лидером в момент присоединения инстанса к кластеру.
+Генератор имен использует следующую схему: имя тира, номер репликасета,
+номер инстанса в данном репликасете, с разделением через знак
+подчеркивания.
+
+Пример: `default_1_1`.
 
 Аналогичная переменная окружения: `PICODATA_INSTANCE_NAME`<br>
 Аналогичный параметр файла конфигурации: [`instance.name`]
@@ -353,8 +358,12 @@ picodata run --peer server-1.picodata.int:13301,server-2.picodata.int:13301
 `--replicaset-name <NAME>`
 
 Имя репликасета. Используется при инициализации кластера и присоединении
-инстанса к уже существующему кластеру. При отсутствии параметра
-репликасет будет выбран автоматически на основе зон доступности.
+инстанса к уже существующему кластеру. При отсутствии параметра имя
+репликасета будет сгенерировано автоматически. Генератор имен использует
+следующую схему: имя тира, номер репликасета в данном тире, с
+разделением через знак подчеркивания.
+
+Пример: `default_1`.
 
 Аналогичная переменная окружения: `PICODATA_REPLICASET_NAME`<br>
 Аналогичный параметр файла конфигурации: [`instance.replicaset_name`]
diff --git a/docs/reference/config.md b/docs/reference/config.md
index 7348c0abba22ed7df0d20de6c0272faed7263b63..aa14b3863570075d06f4d02c9b30d54217de69cf 100644
--- a/docs/reference/config.md
+++ b/docs/reference/config.md
@@ -486,6 +486,11 @@ picodata run -c instance.memtx.memory=128M
 
 Имя инстанса. При отсутствии параметра значение будет автоматически
 сгенерировано raft-лидером в момент присоединения инстанса к кластеру.
+Генератор имен использует следующую схему: имя тира, номер репликасета,
+номер инстанса в данном репликасете, с разделением через знак
+подчеркивания.
+
+Пример: `default_1_1`.
 
 Данные:
 
@@ -574,8 +579,12 @@ picodata run -c instance.pg.ssl=true
 ### instance.replicaset_name {: #instance_replicaset_name }
 
 Имя репликасета. Используется при инициализации кластера и присоединении
-инстанса к уже существующему кластеру. При отсутствии параметра репликасет
-будет выбран автоматически на основе зон доступности.
+инстанса к уже существующему кластеру. При отсутствии параметра имя
+репликасета будет сгенерировано автоматически. Генератор имен использует
+следующую схему: имя тира, номер репликасета в данном тире, с
+разделением через знак подчеркивания.
+
+Пример: `default_1`.
 
 Данные: