diff --git a/docs/tutorial/connecting.md b/docs/tutorial/connecting.md
index 6d97dd0955abe93dbbe3625ce5b97d832b738ccf..a828f352fbe402fe0e64c9473936a360ee679876 100644
--- a/docs/tutorial/connecting.md
+++ b/docs/tutorial/connecting.md
@@ -5,8 +5,8 @@
 
 По умолчанию консоль, в которой происходит запуск инстанса Picodata,
 служит для вывода отладочного журнала инстанса. Для ввода команд
-следует подключиться к Picodata из другой консоли. При этом возможны
-несколько вариантов подключения:
+следует подключиться к Picodata из другой консоли. Возможны
+несколько вариантов:
 
 - Подключение к [консоли администратора](#admin_console) (`picodata admin`)
 - Подключение к [SQL-консоли](#sql_console) (`picodata connect`)
@@ -51,8 +51,8 @@ picodata>
 
 По умолчанию у Администратора СУБД отсутствует пароль, поэтому
 подключиться к консоли администратора возможно только при наличии
-доступа к ОС, в которой запущен инстанс Picodata. Для того чтобы
-подключаться к инстансу по сети, задайте пароль администратора:
+доступа к файлу сокета средствами ОС. Для того чтобы иметь возможность
+подключиться к инстансу по сети, задайте пароль администратора:
 
 ```sql
 ALTER USER "admin" WITH PASSWORD 'T0psecret'
@@ -68,7 +68,7 @@ picodata connect admin@127.0.0.1:3301
 Кроме того, задать пароль администратора можно при инициализации
 кластера, установив переменную окружения `PICODATA_ADMIN_PASSWORD`
 для его первого инстанса. При повторных запусках данная переменная
-игнорируется.
+будет игнорироваться.
 
 См. также:
 
@@ -78,15 +78,14 @@ picodata connect admin@127.0.0.1:3301
 
 Для того чтобы использовать пользовательскую консоль, нужно сначала
 создать учетную запись пользователя в административной консоли.
-
-Для этого можно использовать следующую команду:
+Используйте для этого следующую команду:
 
 ```SQL
 CREATE USER "alice" WITH PASSWORD 'T0psecret';
 ```
 
-Чтобы новый пользователь мог создавать таблицы, ему понадобится
-соответствующая привилегия:
+Чтобы новый пользователь мог создавать таблицы, выдайте ему
+соответствующую привилегию:
 
 ```SQL
 GRANT CREATE TABLE TO "alice";
@@ -95,39 +94,31 @@ GRANT CREATE TABLE TO "alice";
 ### Автоматизация первичной настройки  {: #automate_setup }
 
 Первичную настройку пользователей и их прав в консоли администратора
-можно автоматизировать: сохранить набор SQL-команд в отдельный файл, и
-затем подать его на вход обработчику `picodata admin`.
-
-Для примера подготовим следующий набор команд, предварив их
-[разделителем](#backslash_commands) (для поддержки многострочного
-ввода):
-
-```shell
-cat ../setup.sql
-```
+можно автоматизировать. Для этого сохраните следующий набор команд
+в виде скрипта:
 
-```sql
-\set delimiter ;
-ALTER USER "admin" WITH PASSWORD 'T0psecret';
-CREATE USER "alice" WITH PASSWORD 'T0psecret';
-GRANT CREATE TABLE TO "alice";
-GRANT READ TABLE TO "alice";
-GRANT WRITE TABLE TO "alice";
-```
+???+ example "setup.sql"
+    ```sql
+    \set delimiter ;
+    ALTER USER "admin" WITH PASSWORD 'T0psecret';
+    CREATE USER "alice" WITH PASSWORD 'T0psecret';
+    GRANT CREATE TABLE TO "alice";
+    GRANT READ TABLE TO "alice";
+    GRANT WRITE TABLE TO "alice";
+    ```
 
-После этого можно выполнить набор команд:
+Запустите этот скрипт в консоли администратора:
 
 ```shell
 picodata admin ./admin.sock < ../setup.sql
 ```
 
-Вывод:
+Пример вывода:
 
 ```
 Connected to admin console by socket path "admin.sock"
 type '\help' for interactive help
 Delimiter changed to ';'
-Language switched to SQL
 1
 1
 1
@@ -136,16 +127,15 @@ Language switched to SQL
 Bye
 ```
 
-Команды будут выполнены последовательно. Числа в начале строк означают
-количество измененных строк после каждой команды. В конце управление
-возвращается терминалу (консоль Picodata не останется запущенной).
+Команды будут выполнены последовательно. Числа означают количество
+измененных строк после каждой команды.
 
 ## SQL-консоль {: #sql_console }
 
 SQL-консоль позволяет выполнять распределенные SQL-команды в рамках
 кластера. После того как в системе создана пользовательская учетная
 запись, можно подключиться к SQL-консоли любого локального или
-удаленного инстанса. Для этого используется команда `picodata connect`.
+удаленного инстанса. Для этого используйте команду `picodata connect`.
 Пример для `127.0.0.1`:
 
 ```
@@ -153,10 +143,7 @@ picodata connect alice@127.0.0.1:3301
 ```
 
 В соответствии с доступными ему привилегиями, пользователь сможет
-работать в консоли с таблицами. Возможность пользователя подключаться
-может быть ограничена [соответствующей привилегией LOGIN].
-
-[соответствующей привилегией LOGIN]: ../tutorial/access_control.md#privileges
+работать в консоли с таблицами.
 
 ## Встроенная справка в консоли {: #builtin_help }