deploy.md: revise user story for picodata expel

docs/reference/cli.md

@@ -345,9 +345,12 @@ picodata> pico.cas({
 Исключает инстанс Picodata из состава кластера.
 
 ```
-picodata expel [OPTIONS]
+picodata expel [OPTIONS] <INSTANCE_ID>
 ```
 
+- `INSTANCE_ID`: Название инстанса
+
+
 ### --cluster-id {: #expel_cluster_id }
 
 `--cluster-id <NAME>`
@@ -356,12 +359,6 @@ picodata expel [OPTIONS]
 
 Значение по умолчанию: `demo`
 
-### --instance-id {: #expel_instance_id }
-
-`--instance-id <NAME>`
-
-Имя инстанса, который следует исключить.
-
 ### --peer {: #expel_peer }
 
 `--peer <[HOST][:PORT]>`

docs/tutorial/deploy.md

@@ -168,41 +168,38 @@ picodata run --init-replication-factor 2 --failure-domain region=us,zone=us-west
 Добавляемый инстанс использует алгоритм `discovery` для получения от
 raft информации о текущем лидере raft-группы.
 
-## Удаление инстансов из кластера (expel) {: #instance_expulsion }
+## Удаление инстанса (expel) {: #expel }
 
-Удаление — это принятие кластером решения, что некий инстанс больше не
-является участником кластера. После удаления кластер больше не будет
-ожидать присутствия инстанса в кворуме, а сам инстанс завершится. При
-удалении текущего лидера будет принудительно запущен выбор нового
-лидера.
+Данная процедура позволяет исключить инстанс из состава кластера.
 
-Для удаления используется команда `picodata expel` с необходимым набором
-параметров. Данная команда выполняется от имени Администратора СУБД
-(`admin`), поэтому для ее работы необходимо, чтобы для пользователя `admin`
-был ранее установлен пароль. Например:
+Если инстанс хранит сегменты шардированных данных, перед его удалением
+данные будет автоматически перераспределены.
 
-```bash
-picodata admin admin.sock
-ALTER USER "admin" WITH PASSWORD 'T0psecret'
-```
+<!--
+Для референса:
+
+Если удаляемый инстанс является голосующим в Raft, то для его замены
+автоматически будет выбран новый голосующий узел.
 
-После этого можно использовать `picodata expel`, указав параметры по
-следующей схеме:
+Если удаляемый инстанс является raft-лидером, то будут организованы
+новые выборы.
+-->
+
+Для удаления инстанса из кластера потребуется пароль Администратора СУБД
+(`admin`), который должен быть заранее установлен в консоли администратора:
 
 ```bash
-picodata expel --instance-id <instance-id> [--cluster-id <cluster-id>] [--peer <peer>]
+picodata admin ./admin.sock
+ALTER USER "admin" WITH PASSWORD 'T0psecret'
 ```
 
-где `cluster-id` и `instance-id` — данные об удаляемом инстансе, `peer`
-— любой инстанс кластера.
-
-Пример:
+Для удаления инстанса из кластера используйте команду [picodata
+expel](../reference/cli.md#expel):
 
 ```bash
-picodata expel --instance-id i3 --peer 192.168.100.123
+picodata expel barsik --peer 192.168.0.1:3301
 ```
 
 См. также:
 
 - [Подключение и работа в консоли](connecting.md)
-

docs/tutorial/install.md

@@ -230,8 +230,8 @@ test result: ok. 6 passed; 0 failed; finished in 0.88s
 Порядок действий для удаления Picodata:
 
 - перед удалением необходимо [остановить и вывести из
-  кластера](../tutorial/deploy.md#instance_expulsion) все запущенные на
-  данном хосте инстансы Picоdata
+  кластера](../tutorial/deploy.md#expel) все запущенные на данном хосте
+  инстансы Picоdata
 - для каждого инстанса требуется удалить его [рабочие
   файлы](../architecture/instance_runtime_files.md). Например: `rm -rf
   *.xlog *.vylog *.snap *.sock`