From 39d443176019f8b54c3fa959602bb6c15577beff Mon Sep 17 00:00:00 2001
From: "a.tolstoy" <a.tolstoy@picodata.io>
Date: Fri, 4 Oct 2024 15:26:35 +0300
Subject: [PATCH] review & edits

---
 docs/tutorial/deploy.md | 56 ++++++++++++++++++-----------------------
 1 file changed, 24 insertions(+), 32 deletions(-)

diff --git a/docs/tutorial/deploy.md b/docs/tutorial/deploy.md
index d5005fdb..202b27f5 100644
--- a/docs/tutorial/deploy.md
+++ b/docs/tutorial/deploy.md
@@ -133,30 +133,31 @@ TBD:
 
 ## Кластер из нескольких тиров {: #tiered_cluster }
 
-[Тиры][tiers] - функциональность, позволяющая управлять
-физическим расположением шардированных таблиц.
-В части хранения шардированных данных тир
-представляет собой отдельную группу хранения.
-Другими словами - для каждой шардированной таблицы
-определена принадлежность конкретному тиру.
-В свою очередь глобальные таблицы создаются на каждом
-инстансе. Глобальные на тир таблицы отсутствуют.
+Для управления физическим расположением шардированных таблиц в Picodata
+используются [тиры][tiers], которые позволяют создавать отдельные группы
+с шардированными данными. Другими словами — для каждой шардированной
+таблицы определена принадлежность конкретному тиру. В свою очередь,
+глобальные таблицы создаются на каждом инстансе и не привязаны к тирам.
+
+См. также:
+
+- [Шардирование](../overview/description.md#sharding)
 
 <!--
 Круто было бы здесь иллюстрацию иметь.
 -->
 
-Набор тиров и принадлежность
-инстанса тиру определяется на момент деплоя кластера и в дальнейшем
+Набор тиров, равно как и принадлежность
+инстанса тиру, определяется на момент развертывания кластера и в дальнейшем
 не изменяется. Каждый инстанс принадлежит только одному тиру.
 
+При этом, в запущенном кластере сохраняется возможность переопределять
+некоторые из глобальных параметров кластера на уровне тира. Например,
+[replication_factor].
 
-Также полезной может оказаться возможность переопределять некоторые из
-глобальных параметров кластера на уровне тира. Например [replication_factor].
-
-В этом разделе мы запустим кластер, состоящий из двух тиров
+В этом примере показан запуск кластера, состоящего из двух тиров
 с именами "blue" и "red". Файл конфигурации и скрипты инстансов
-отличаются от используемых на предыдущем шаге только в местах
+отличаются от используемых на предыдущем шаге только в местах,
 относящимся к тирам.
 
 <!--
@@ -167,14 +168,13 @@ TBD:
 
 #### Файл конфигурации {: #tiered_cluster_config }
 
-Тиры создаются только один раз на этапе [бутстрапа кластера][cluster_bootstrap] по информации
-из [конфигурационного файла][config_file_description] и после этого не изменяются.
-Описание тиров содержится в секции "cluster.tier". Подробную информацию
-о параметрах настройки тиров можно найти в разделе
-[Параметры тиров][config_file_section_tier].
+Тиры создаются только один раз на этапе [бутстрапа
+кластера][cluster_bootstrap] с учетом параметров `cluster.tier.*`,
+заданных в [файле конфигурации][config_file_description] и после этого
+не изменяются.
 
-В секции "cluster.tier" конфигурационного файла опишите необходимые тиры.
-Для развертывания кластера используйте следующий файл конфигурации:
+Для развертывания кластера используйте следующий файл конфигурации, в
+котором заданы имена тиров и определены их параметры:
 
 ???+ example "tiered_cluster.md"
     ```yaml
@@ -208,13 +208,8 @@ TBD:
 
 Создайте скрипты запуска для инстансов, указав в них путь к общему файлу
 конфигурации (в примере он находится в той же директории, что и сами
-скрипты), а также индивидуальные настройки. С помощью `PICODATA_TIER` нужно указать
-к какому тиру будет принадлежать инстанс:
-
-<!--
-Криво двигается highlight по разделам (справа) при скроле.
-Может связано с именем? (i1), сверху такое же.
--->
+скрипты), а также индивидуальные настройки. С помощью `PICODATA_TIER`
+нужно указать, к какому тиру будет принадлежать инстанс:
 
 ???+ example "i1"
     ```shell
@@ -263,13 +258,10 @@ TBD:
     picodata run
     ```
 
-Про работу с шардированными таблицами подбробнее в разделе SQL.
-
 [replication_factor]: ../overview/glossary.md#replication_factor
 [tiers]: ../overview/glossary.md#tier
 [cluster_bootstrap]: ../overview/glossary.md#bootstrap
 [config_file_description]: ../reference/config.md#config_file_description
-[config_file_section_tier]: ../reference/config.md#cluster_tier_tier_can_vote
 
 ## Зоны доступности (failure domains) {: #failure_domains }
 
-- 
GitLab