Убрать все упоминания Yandex Database из Core документации

fix ydb-name fix ydb-full-name fix ydb fix yandex database ref:658041100ae1852074fff0fa8c2712333634b674
author: bazeltsev <bazeltsev@yandex-team.ru> 2022-02-23 14:02:04 +0300
committer: bazeltsev <bazeltsev@yandex-team.ru> 2022-02-23 14:02:04 +0300
commit: cd5c4d9254f66cc8ea5753a83971e35cc32c1526 (patch)
tree: 8acb3a2bd4d6766ed107f6a225146e6523af99b6
parent: eb3d75399185dcb1bf88ae2360fddbbfe9429390 (diff)
download: ydb-cd5c4d9254f66cc8ea5753a83971e35cc32c1526.tar.gz
84 files changed, 248 insertions, 232 deletions
diff --git a/ydb/docs/ru/core/best_practices/_includes/paging.md b/ydb/docs/ru/core/best_practices/_includes/paging.md
index d2edb48cc6..766b3c79ee 100644
--- a/ydb/docs/ru/core/best_practices/_includes/paging.md
+++ b/ydb/docs/ru/core/best_practices/_includes/paging.md
@@ -52,7 +52,7 @@ ORDER BY city, number LIMIT $limit;
 
 {% note warning "Значение NULL в ключевой колонке" %}
 
-В YDB все колонки, включая ключевые, могут иметь значение NULL. Несмотря на это использование NULL в качестве значений в ключевых колонках крайне не рекомендуется, так как по SQL стандарту NULL нельзя сравнивать. Как следствие, лаконичные SQL конструкции с простыми операторами сравнения будут работать некорректно. Вместо них придется использовать громоздкие конструкции с IS NULL/IS NOT NULL выражениями.
+В {{ ydb-short-name }} все колонки, включая ключевые, могут иметь значение NULL. Несмотря на это использование NULL в качестве значений в ключевых колонках крайне не рекомендуется, так как по SQL стандарту NULL нельзя сравнивать. Как следствие, лаконичные SQL конструкции с простыми операторами сравнения будут работать некорректно. Вместо них придется использовать громоздкие конструкции с IS NULL/IS NOT NULL выражениями.
 
 {% endnote %}
 
diff --git a/ydb/docs/ru/core/best_practices/_includes/schema_design.md b/ydb/docs/ru/core/best_practices/_includes/schema_design.md
index 172c7d4612..5f595cd388 100644
--- a/ydb/docs/ru/core/best_practices/_includes/schema_design.md
+++ b/ydb/docs/ru/core/best_practices/_includes/schema_design.md
@@ -13,12 +13,12 @@
 
 Следует тщательно подходить к выбору первичного ключа и избегать ситуаций, при которых какая-то малая часть БД нагружена существенно больше, чем остальные части БД.
 
-Например, из-за того, что все таблицы в {{ ydb-short-name }} отсортированы по возрастанию первичного ключа, запись в таблицу данных с монотонно возрастающим первичным ключом приведет к тому, что новые данные будут записываться в конец таблицы. Так как YDB разделяет таблицы на партиции по диапазонам ключей, вставки будут обрабатываться одним конкретным сервером, отвечающим за "последнюю" партицию. Сосредоточение нагрузки на одном сервере приведет к медленной загрузке данных и неэффективному использованию распределенной системы.
+Например, из-за того, что все таблицы в {{ ydb-short-name }} отсортированы по возрастанию первичного ключа, запись в таблицу данных с монотонно возрастающим первичным ключом приведет к тому, что новые данные будут записываться в конец таблицы. Так как {{ ydb-short-name }} разделяет таблицы на партиции по диапазонам ключей, вставки будут обрабатываться одним конкретным сервером, отвечающим за "последнюю" партицию. Сосредоточение нагрузки на одном сервере приведет к медленной загрузке данных и неэффективному использованию распределенной системы.
 В качестве примера рассмотрим запись лога пользовательских событий в таблицу со схемой ```( timestamp, userid, userevent, PRIMARY KEY (timestamp, userid) )```.
 
 ```timestamp``` монотонно возрастает, как следствие, все записи будут записываться в конец таблицы и "последняя" партиция, которая отвечает за данный диапазон ключей, будет обслуживать все записи в таблицу. Это приведет к падению производительности записи.
 
-В YDB поддерживается автоматическое разделение партиции при достижении порогового размера (обычно около 2 ГБ). Но в рассматриваемом случае после разделения новая партиция начнет принимать всю нагрузку на запись и ситуация повторится.
+В {{ ydb-short-name }} поддерживается автоматическое разделение партиции при достижении порогового размера (обычно около 2 ГБ). Но в рассматриваемом случае после разделения новая партиция начнет принимать всю нагрузку на запись и ситуация повторится.
 
 ## Приемы, позволяющие равномерно распределить нагрузку по партициям таблицы {#balance-shard-load}
 
diff --git a/ydb/docs/ru/core/best_practices/_includes/table_sharding.md b/ydb/docs/ru/core/best_practices/_includes/table_sharding.md
index ddc7d0387c..6c440315e8 100644
--- a/ydb/docs/ru/core/best_practices/_includes/table_sharding.md
+++ b/ydb/docs/ru/core/best_practices/_includes/table_sharding.md
@@ -1,14 +1,14 @@
 # Рекомендации по партицированию таблиц
 
-Таблицы в YDB отсортированы по возрастанию первичного ключа. Партицирование таблиц осуществляется путём разбиения диапазона значений ключа на последовательные непересекающиеся диапазоны - партиции.
+Таблицы в {{ ydb-short-name }} отсортированы по возрастанию первичного ключа. Партицирование таблиц осуществляется путём разбиения диапазона значений ключа на последовательные непересекающиеся диапазоны - партиции.
 
-Благодаря партицированию данные таблицы могут распределяться по множеству устройств хранения, а нагрузка при работе с таблицей может задействовать больше процессорных ядер и пропускной способности сети. Вместе с тем слишком большое количество партиций в таблице может добавлять накладные расходы по использованию памяти и процессорного времени. Таким образом оптимальное партиционирование прямым образом влияет на эффективность выполнения запросов. Для достижения оптимального партицирования в YDB есть как средства для задания первоначального разбиения таблицы при её создании, так и способы последующего автоматического партиционирования.
+Благодаря партицированию данные таблицы могут распределяться по множеству устройств хранения, а нагрузка при работе с таблицей может задействовать больше процессорных ядер и пропускной способности сети. Вместе с тем слишком большое количество партиций в таблице может добавлять накладные расходы по использованию памяти и процессорного времени. Таким образом оптимальное партиционирование прямым образом влияет на эффективность выполнения запросов. Для достижения оптимального партицирования в {{ ydb-short-name }} есть как средства для задания первоначального разбиения таблицы при её создании, так и способы последующего автоматического партиционирования.
 
 При создании таблицы можно задать первоначальное партицирование одним из 2 способов:
 * Задать равномерное партицирование по первой колонке первичного ключа, если эта колонка имеет тип UInt32 или UInt64. В этом случае необходимо явно задать количество партиций.
 * Задать точные ключи партицирования, которые определят количество и границы первоначальных партиций.
 
-YDB поддерживает 2 способа автопартицирования таблиц:
+{{ ydb-short-name }} поддерживает 2 способа автопартицирования таблиц:
 * по размеру данных;
 * по нагрузке на даташард (даташард - компонент системы обслуживающий партицию таблицы).
 
diff --git a/ydb/docs/ru/core/best_practices/_includes/timeouts.md b/ydb/docs/ru/core/best_practices/_includes/timeouts.md
index fd117c1492..67bc276efa 100644
--- a/ydb/docs/ru/core/best_practices/_includes/timeouts.md
+++ b/ydb/docs/ru/core/best_practices/_includes/timeouts.md
@@ -1,5 +1,5 @@
 ---
-title: Использование таймаутов в Yandex Database (YDB)
+title: Использование таймаутов в YDB
 description: 'Значение operation_timeout определяет время, в течение которого результат запроса интересен пользователю. Если за данное время операция не выполнилась, сервер возвращает ошибку c кодом Timeout и попытается прекратить выполнение запроса, однако отмена запроса не гарантируется. Всегда рекомендуется устанавливать и таймаут на операцию, и транспортный таймаут. '
 ---
 
diff --git a/ydb/docs/ru/core/concepts/_includes/connect.md b/ydb/docs/ru/core/concepts/_includes/connect.md
index b9cbec42aa..6e18a6a8c1 100644
--- a/ydb/docs/ru/core/concepts/_includes/connect.md
+++ b/ydb/docs/ru/core/concepts/_includes/connect.md
@@ -2,7 +2,7 @@
 
 {% include [overlay/ui.md](connect_overlay/ui.md) %}
 
-Для соединения с БД YDB из YDB CLI или приложения, использующего YDB SDK, вам потребуется предоставить следующие данные:
+Для соединения с БД {{ ydb-short-name }} из {{ ydb-short-name }} CLI или приложения, использующего {{ ydb-short-name }} SDK, вам потребуется предоставить следующие данные:
 
 1. Эндпоинт
 3. Аутентификационная информация
@@ -10,7 +10,7 @@
 
 ## Эндпоинт {#endpoint}
 
-Эндпоинт (`endpoint`) - строка в формате `protocol://host:port`, предоставляемая владельцем кластера YDB для корректной маршрутизации запросов клиента к его базам данных через сетевую инфраструктуру, и установки сетевого соединения. Для облачных баз данных `endpoint` показывается в консоли управления на странице требуемой БД, а также обычно может быть получено через CLI облачного поставщика. В корпоративных окружениях имена эндпоинтов YDB предоставляются командой администраторов, или также могут быть получены в консоли управления внутренним облаком.
+Эндпоинт (`endpoint`) - строка в формате `protocol://host:port`, предоставляемая владельцем кластера {{ ydb-short-name }} для корректной маршрутизации запросов клиента к его базам данных через сетевую инфраструктуру, и установки сетевого соединения. Для облачных баз данных `endpoint` показывается в консоли управления на странице требуемой БД, а также обычно может быть получено через CLI облачного поставщика. В корпоративных окружениях имена эндпоинтов {{ ydb-short-name }} предоставляются командой администраторов, или также могут быть получены в консоли управления внутренним облаком.
 
 {% include [overlay/endpoint.md](connect_overlay/endpoint.md) %}
 
@@ -25,13 +25,13 @@
 
 После успешной установки сетевого соединения сервер принимает к обработке запросы от клиента, в которых передается аутентификационная информация. На её основании сервер определяет учетную запись (аккаунт) клиента и проверяет доступ на выполнение запроса.
 
-Основная схема работы предполагает наличие отдельной системы управления учетными данными и доступами - [IAM (Identity and Access Management)](https://en.wikipedia.org/wiki/Identity_management). IAM выдает привязанный к учетной записи токен, который передается клиентом YDB на сервер вместе с запросом. Сервер YDB обращается к IAM для проверки токена и доступа на выполнение запрошенной операции, и кеширует результат.
+Основная схема работы предполагает наличие отдельной системы управления учетными данными и доступами - [IAM (Identity and Access Management)](https://en.wikipedia.org/wiki/Identity_management). IAM выдает привязанный к учетной записи токен, который передается клиентом {{ ydb-short-name }} на сервер вместе с запросом. Сервер {{ ydb-short-name }} обращается к IAM для проверки токена и доступа на выполнение запрошенной операции, и кеширует результат.
 
-Также YDB поддерживает аутентификацию по логину и паролю без взаимодействий с IAM, но практическое применение такой схемы ограничено простыми конфигурациями, в первую очередь локальными.
+Также {{ ydb-short-name }} поддерживает аутентификацию по логину и паролю без взаимодействий с IAM, но практическое применение такой схемы ограничено простыми конфигурациями, в первую очередь локальными.
 
 ### Режимы аутентификации {#auth-modes}
 
-Клиент YDB (CLI или SDK) поддерживают следующие режимы выбора токена для передачи в запросах:
+Клиент {{ ydb-short-name }} (CLI или SDK) поддерживают следующие режимы выбора токена для передачи в запросах:
 
 - **Anonymous** - в запросах передается пустой токен
 - **Access Token** - параметром для клиента (SDK или CLI) задается фиксированный токен, который передается в запросы
@@ -41,37 +41,50 @@
 
 Любой обладатель валидного токена может получить доступ на выполнение операций, поэтому главная задача системы безопасности -- обеспечение секретности токена и предотвращение его компрометации.
 
-Режимы аутентификации с ротацией токена **Refresh Token** и **Service Account Key** обеспечивают больший уровень безопасности по сравнению с режимом с фиксированным токеном **Access Token**, так как на сервер YDB по сети передаются только короткоживущие секреты.
+Режимы аутентификации с ротацией токена **Refresh Token** и **Service Account Key** обеспечивают больший уровень безопасности по сравнению с режимом с фиксированным токеном **Access Token**, так как на сервер {{ ydb-short-name }} по сети передаются только короткоживущие секреты.
 
 Максимальная безопасность и производительность обеспечивается при использовании режима **Metadata**, так как он исключает необходимость работы с секретами при развертывании приложения, а также позволяет обратиться к IAM и закешировать токен заранее, до запуска приложения.
 
 При выборе режима аутентификации среди поддерживаемых сервером и окружением, следует руководствоваться следующими рекомендациями:
 
+<<<<<<< ydb/docs/ru/core/concepts/_includes/connect.md
 - **Anonymous** обычно применяется на самостоятельно разворачиваемых локальных кластерах YDB, недоступных по сети
 - **Access Token** применяется при отсутствии поддержки других режимов на стороне сервера, или в настроечных/отладочных целях. Он не требует взаимодействий клиента с IAM. Однако, если IAM поддерживает API для ротации токенов, то обычно выдаваемые таким IAM фиксированные токены имеют короткий срок жизни, что вынуждает регулярно обновлять их в IAM вручную заново.
+=======
+- **Anonymous** обычно применяется на самостоятельно разворачиваемых локальных кластерах {{ ydb-short-name }}, недоступных по сети
+- **Access Token** применяется при отсутствии поддержки других режимов на стороне сервера, или в настроечных/отладочных целях. Он не требует взаимодействий клиента с IAM. Однако, если IAM поддерживает API для ротации токенов, то обычно выдываемые таким IAM фиксированные токены имеют короткий срок жизни, что вынуждает регулярно обновлять их в IAM вручную заново.
+>>>>>>> ydb/docs/ru/core/concepts/_includes/connect.md
 - **Refresh Token** может применяться при выполнении разовых ручных операций под персональной учетной записью, например, связанных с обслуживанием данных в БД, выполнением ad-hoc операций в CLI, или запусками приложений с рабочей станции. Такой токен можно получить вручную в IAM один раз на долгий срок, и сохранить в переменной окружения на личной рабочей станции для автоматического применения при запуске CLI без дополнительных параметров аутентификации.
 - **Service Account Key** применяется в первую очередь для приложений, рассчитанных на эксплуатацию в окружениях, где поддерживается режим **Metadata**, при их тестировании вне таких окружений (например, на рабочей станции). Также он может применяться для приложений вне таких окружений, работая как аналог **Refresh Token** для сервисных учетных записей. В отличие от персональной учетной записи, объекты доступа и роли сервисной учетной записи могуть быть ограничены.
 - **Metadata** применяется при разворачивании приложений в облаках. В настоящее время этот режим поддерживается на виртуальных машинах и в Cloud Functions Yandex.Cloud. 
 
+<<<<<<< ydb/docs/ru/core/concepts/_includes/connect.md
 Токен для указания в параметрах может быть получен в системе IAM, с которой связана конкретная установка YDB. В частности, для сервиса YDB в Yandex.Cloud применяется Yandex.Passport OAuth и сервисные аккаунты Yandex.Cloud. При использовании YDB в корпоративных контекстах могут применяться стандартные для данной организации системы централизованной аутентификации.
 
 {% include [overlay/auth_choose.md](connect_overlay/auth_choose.md) %}
 
 При использовании режимов, предусматривающих обращение клиента YDB к IAM, дополнительно может быть задан URL IAM, предоставляющий API выдачи токенов. по умолчанию в существующих SDK и CLI производится попытка обращения к API IAM Yandex.Cloud, размещенному на `iam.api.cloud.yandex.net:443`.
+=======
+Токен для указания в параметрах может быть получен в системе IAM, с которой связана конкретная установка {{ ydb-short-name }}. В частности, для сервиса {{ ydb-short-name }} в Yandex.Cloud применяется Yandex.Passport OAuth и севисные аккаунты Yandex.Cloud. При использовании {{ ydb-short-name }} в корпоративных контекстах могут применяться стандартные для данной организации системы централизованной аутентификации.
+
+{% include [overlay/auth_choose.md](connect_overlay/auth_choose.md) %}
+
+При использовании режимов, предусматривающих обращение клиента {{ ydb-short-name }} к IAM, дополнительно может быть задан URL IAM, предоставляющий API выдачи токенов. По-умолчанию в существующих SDK и CLI производится попытка обращения к API IAM Yandex.Cloud, размещенному на `iam.api.cloud.yandex.net:443`.
+>>>>>>> ydb/docs/ru/core/concepts/_includes/connect.md
 
 ## Размещение базы данных {#database}
 
-Размещение базы данных (`database`) - строка, определяющая где на кластере YDB находится база данных, к которой адресован запрос. Имеет структуру [пути к файлу](https://ru.wikipedia.org/wiki/Путь_к_файлу), с использованием символа `/` в качестве разделителя. Начинается всегда с символа `/`.
+Размещение базы данных (`database`) - строка, определяющая где на кластере {{ ydb-short-name }} находится база данных, к которой адресован запрос. Имеет структуру [пути к файлу](https://ru.wikipedia.org/wiki/Путь_к_файлу), с использованием символа `/` в качестве разделителя. Начинается всегда с символа `/`.
 
-На кластере YDB может быть развернуто множество баз данных, и их размещение определяется конфигурацией кластера. Как и эндпоинт, для облачных баз данных `database` показывается в консоли управления на странице требуемой БД, а также обычно может быть получено через CLI облачного поставщика.
+На кластере {{ ydb-short-name }} может быть развернуто множество баз данных, и их размещение определяется конфигурацией кластера. Как и эндпоинт, для облачных баз данных `database` показывается в консоли управления на странице требуемой БД, а также обычно может быть получено через CLI облачного поставщика.
 
-При использовании облачных решений базы данных на кластере YDB создаются и размещаются в режиме самообслуживания, не требуя участия владельца и администраторов кластера.
+При использовании облачных решений базы данных на кластере {{ ydb-short-name }} создаются и размещаются в режиме самообслуживания, не требуя участия владельца и администраторов кластера.
 
 {% include [overlay/database.md](connect_overlay/database.md) %}
 
 {% note warning %}
 
-Приложения не должны как-либо интерпретировать количество и значение каталогов в `database`, так как они определяются конфигурацией кластера YDB. Например, при работе с сервисом YDB в Yandex.Cloud `database` сейчас имеет структуру `region_name/cloud_id/database_id`, однако этот формат может быть изменен в будущем для новых БД.
+Приложения не должны как-либо интерпретировать количество и значение каталогов в `database`, так как они определяются конфигурацией кластера {{ ydb-short-name }}. Например, при работе с сервисом {{ ydb-short-name }} в Yandex.Cloud `database` сейчас имеет структуру `region_name/cloud_id/database_id`, однако этот формат может быть изменен в будущем для новых БД.
 
 {% endnote %}
 
@@ -85,8 +98,8 @@
 
 В специализированных статьях описано, как определять параметры соединения на клиенте:
 
-* [Соединение с БД и аутентификация в YDB CLI](../../reference/ydb-cli/connect.md)
-* [Аутентификация в YDB SDK](../../reference/ydb-sdk/auth.md)
+* [Соединение с БД и аутентификация в {{ ydb-short-name }} CLI](../../reference/ydb-cli/connect.md)
+* [Аутентификация в {{ ydb-short-name }} SDK](../../reference/ydb-sdk/auth.md)
 
 ## Дополнительная информация {#addition}
 
@@ -94,10 +107,10 @@
 
 При использовании протокола с шифрованием ([gRPC over TLS](https://grpc.io/docs/guides/auth/), или grpcs) продолжение сетевого соединения возможно только в том случае, если клиент уверен в том, что ему действительно отвечает подлинный сервер, с которым он пытается установить соединение, а не кто-то посередине, перехвативший запрос в сети. Это обеспечивается проверкой через [цепочки доверия](https://ru.wikipedia.org/wiki/Цепочка_доверия), для работы которой на клиенте должен быть установлен т.н. корневой сертификат.
 
-В состав операционных систем, на которых запускается клиент, уже входит набор корневых сертификатов от основных мировых центров сертификации. Однако, владелец кластера YDB может использовать свой центр сертификации, не связанный ни с одним из мировых, что часто встречается в корпоративных окружениях, и почти всегда применяется при самостоятельном развертывании кластеров с поддержкой шифрования на соединениях. В этом случае владелец кластера должен каким-либо образом передать свой корневой сертификат для использования на стороне клиента. Такой сертификат может быть установлен в хранилище сертификатов операционной системы, где запускается клиент (вручную пользователем или корпоративной командой администраторов ОС), или встроен в состав самого клиента (как это сделано для Yandex.Cloud в YDB CLI и SDK).
+В состав операционных систем, на которых запускается клиент, уже входит набор корневых сертификатов от основных мировых центров сертификации. Однако, владелец кластера {{ ydb-short-name }} может использовать свой центр сертификации, не связанный ни с одним из мировых, что часто встречается в корпоративных окружениях, и почти всегда применяется при самостоятельном развертывании кластеров с поддержкой шифрования на соединениях. В этом случае владелец кластера должен каким-либо образом передать свой корневой сертификат для использования на стороне клиента. Такой сертификат может быть установлен в хранилище сертификатов операционной системы, где запускается клиент (вручную пользователем или корпоративной командой администраторов ОС), или встроен в состав самого клиента (как это сделано для Yandex.Cloud в {{ ydb-short-name }} CLI и SDK).
 
 ### API получения токенов IAM {#token-refresh-api}
 
-Для ротации токенов YDB SDK и CLI используют gRPC-запрос к Yandex.Cloud IAM API [IamToken - create](https://cloud.yandex.ru/docs/iam/api-ref/grpc/iam_token_service#Create). В режиме **Refresh Token** заданный параметром OAuth токен передается в атрибуте `yandex_passport_oauth_token`. В режиме **Service Account Key** на основании заданных атрибутов сервисной учетной записи и ключа шифрования формируется короткоживущий JWT-токен, и передается в атрибуте `jwt`. Исходный код формирования JWT-токена доступен в составе SDK (например, метод `get_jwt()` в [коде на Python](https://github.com/ydb-platform/ydb-python-sdk/blob/main/ydb/iam/auth.py)).
+Для ротации токенов {{ ydb-short-name }} SDK и CLI используют gRPC-запрос к Yandex.Cloud IAM API [IamToken - create](https://cloud.yandex.ru/docs/iam/api-ref/grpc/iam_token_service#Create). В режиме **Refresh Token** заданный параметром OAuth токен передается в атрибуте `yandex_passport_oauth_token`. В режиме **Service Account Key** на основании заданных атрибутов сервисной учетной записи и ключа шифрования формируется короткоживущий JWT-токен, и передается в атрибуте `jwt`. Исходный код формирования JWT-токена доступен в составе SDK (например, метод `get_jwt()` в [коде на Python](https://github.com/ydb-platform/ydb-python-sdk/blob/main/ydb/iam/auth.py)).
 
-YDB SDK и CLI позволяют подменить хост для обращения к API получения токенов, что дает возможность реализовать аналогичный API в корпоративных контекстах.
-\ No newline at end of file
+{{ ydb-short-name }} SDK и CLI позволяют подменить хост для обращения к API получения токенов, что дает возможность реализовать аналогичный API в корпоративных контекстах.
+\ No newline at end of file
diff --git a/ydb/docs/ru/core/concepts/_includes/databases/database.md b/ydb/docs/ru/core/concepts/_includes/databases/database.md
index 287644539e..0a10f5d5ac 100644
--- a/ydb/docs/ru/core/concepts/_includes/databases/database.md
+++ b/ydb/docs/ru/core/concepts/_includes/databases/database.md
@@ -1,8 +1,8 @@
 ## База данных {#database}
 
-_База данных {{ ydb-short-name }} (БД {{ ydb-short-name }})_ — изолированное согласованное множество данных, доступ к которому осуществляется через сервис {{ ydb-full-name }}.
+_База данных {{ ydb-short-name }} (БД {{ ydb-short-name }})_ — изолированное согласованное множество данных, доступ к которому осуществляется через сервис {{ ydb-short-name }}.
 
-Сервис {{ ydb-full-name }}:
+Сервис {{ ydb-short-name }}:
 
 * Принимает сетевые соединения от клиентов и обрабатывает их запросы на изменение и чтение данных.
 * Аутентифицирует и авторизует клиентов.
diff --git a/ydb/docs/ru/core/concepts/_includes/databases/intro.md b/ydb/docs/ru/core/concepts/_includes/databases/intro.md
index 9dbf7a7e25..c72615e3c6 100644
--- a/ydb/docs/ru/core/concepts/_includes/databases/intro.md
+++ b/ydb/docs/ru/core/concepts/_includes/databases/intro.md
@@ -1,6 +1,6 @@
 ---
-title: "Термины и определения {{ ydb-full-name }}"
-description: "База данных (БД) {{ ydb-full-name }} — это изолированное согласованное множество данных, доступ к которому осуществляется через сервис {{ ydb-full-name }}, обеспечивающий масштабируемость, отказоустойчивость, и автоматическую репликацию данных."
+title: "Термины и определения {{ ydb-short-name }}"
+description: "База данных (БД) {{ ydb-short-name }} — это изолированное согласованное множество данных, доступ к которому осуществляется через сервис {{ ydb-short-name }}, обеспечивающий масштабируемость, отказоустойчивость, и автоматическую репликацию данных."
 ---
 
 # Термины и определения
diff --git a/ydb/docs/ru/core/concepts/_includes/datamodel/blockdevice.md b/ydb/docs/ru/core/concepts/_includes/datamodel/blockdevice.md
index d07a3db66f..1d7a5ded89 100644
--- a/ydb/docs/ru/core/concepts/_includes/datamodel/blockdevice.md
+++ b/ydb/docs/ru/core/concepts/_includes/datamodel/blockdevice.md
@@ -1,2 +1,2 @@
 ## Том сетевого блочного устройства
-Одним из примеров применения YDB в качестве платформы для создания широкого спектра систем хранения и обработки данных является реализация [сетевого блочного устройства](https://en.wikipedia.org/wiki/Network_block_device) на базе YDB. Сетевые блочные устройства реализуют интерфейс локального блочного устройства, при этом являются отказоустойчивыми (за счет избыточности) и хорошо масштабируются как по размеру тома, так и по количеству операций ввода-вывода в единицу времени. К недостаткам сетевого блочного устройства можно отнести то, что любая операция ввода-вывода на таком устройстве требует сетевого взаимодействия, что может увеличить latency сетевого устройства по сравнению с локальным. На сетевом блочном устройстве можно развернуть обычную файловую систему и/или запустить приложение, напрямую работающее с блочным устройством, например СУБД.
+Одним из примеров применения {{ ydb-short-name }} в качестве платформы для создания широкого спектра систем хранения и обработки данных является реализация [сетевого блочного устройства](https://en.wikipedia.org/wiki/Network_block_device) на базе {{ ydb-short-name }}. Сетевые блочные устройства реализуют интерфейс локального блочного устройства, при этом являются отказоустойчивыми (за счет избыточности) и хорошо масштабируются как по размеру тома, так и по количеству операций ввода-вывода в единицу времени. К недостаткам сетевого блочного устройства можно отнести то, что любая операция ввода-вывода на таком устройстве требует сетевого взаимодействия, что может увеличить latency сетевого устройства по сравнению с локальным. На сетевом блочном устройстве можно развернуть обычную файловую систему и/или запустить приложение, напрямую работающее с блочным устройством, например СУБД.
diff --git a/ydb/docs/ru/core/concepts/_includes/datamodel/intro.md b/ydb/docs/ru/core/concepts/_includes/datamodel/intro.md
index 753242eef5..1a7c762827 100644
--- a/ydb/docs/ru/core/concepts/_includes/datamodel/intro.md
+++ b/ydb/docs/ru/core/concepts/_includes/datamodel/intro.md
@@ -1,5 +1,5 @@
 # Модель данных и схема
 
-В разделе собраны описания сущностей, которыми оперирует YDB в рамках БД.
-Ядро YDB позволяет гибко реализовывать различные примитивы хранения, поэтому возможно появление в будущем новых сущностей.
+В разделе собраны описания сущностей, которыми оперирует {{ ydb-short-name }} в рамках БД.
+Ядро {{ ydb-short-name }} позволяет гибко реализовывать различные примитивы хранения, поэтому возможно появление в будущем новых сущностей.
 
diff --git a/ydb/docs/ru/core/concepts/_includes/datamodel/pq.md b/ydb/docs/ru/core/concepts/_includes/datamodel/pq.md
index b6f7e43216..b45c176ff1 100644
--- a/ydb/docs/ru/core/concepts/_includes/datamodel/pq.md
+++ b/ydb/docs/ru/core/concepts/_includes/datamodel/pq.md
@@ -1,2 +1,2 @@
 ## Персистентная очередь
-Персистентная очередь состоит из одной или более партиций, каждая партиция представляет собой [FIFO](https://en.wikipedia.org/wiki/FIFO_(computing_and_electronics)) [очередь сообщений](https://en.wikipedia.org/wiki/Message_queue), обеспечивающую надежную доставку между несколькими участниками. Сообщения данных нетипизированы и представляют собой blob данных. Партиция является инструментом параллельности и позволяет обеспечить высокую пропускную способность очереди. Предусмотрены механизмы для реализации at least once и exactly once гарантий работы с персистетной очередью. Персистентная очередь YDB похожа на концепцию topic в [Apache Kafka](https://en.wikipedia.org/wiki/Apache_Kafka).
+Персистентная очередь состоит из одной или более партиций, каждая партиция представляет собой [FIFO](https://en.wikipedia.org/wiki/FIFO_(computing_and_electronics)) [очередь сообщений](https://en.wikipedia.org/wiki/Message_queue), обеспечивающую надежную доставку между несколькими участниками. Сообщения данных нетипизированы и представляют собой blob данных. Партиция является инструментом параллельности и позволяет обеспечить высокую пропускную способность очереди. Предусмотрены механизмы для реализации at least once и exactly once гарантий работы с персистетной очередью. Персистентная очередь {{ ydb-short-name }} похожа на концепцию topic в [Apache Kafka](https://en.wikipedia.org/wiki/Apache_Kafka).
diff --git a/ydb/docs/ru/core/concepts/_includes/datamodel/table.md b/ydb/docs/ru/core/concepts/_includes/datamodel/table.md
index 9976b64438..f9d38de5b7 100644
--- a/ydb/docs/ru/core/concepts/_includes/datamodel/table.md
+++ b/ydb/docs/ru/core/concepts/_includes/datamodel/table.md
@@ -1,5 +1,5 @@
 ## Таблица {#table}
-Таблица в YDB — это [реляционная таблица](https://en.wikipedia.org/wiki/Table_(database)), содержащая набор связанных данных, состоящий из строк и столбцов. каждая из строк представляет собой набор ячеек, предназначенных для хранения значений определенных типов в соответствии со схемой данных. Схема данных определяет имена (names) и типы (types) столбцов таблицы. Пример схемы данных показан на рисунке ниже.
+Таблица в {{ ydb-short-name }} — это [реляционная таблица](https://en.wikipedia.org/wiki/Table_(database)), содержащая набор связанных данных, состоящий из строк и столбцов. каждая из строк представляет собой набор ячеек, предназначенных для хранения значений определенных типов в соответствии со схемой данных. Схема данных определяет имена (names) и типы (types) столбцов таблицы. Пример схемы данных показан на рисунке ниже.
 
 ![Datamodel_of_a_relational_table](../../_assets/datamodel_rtable.png)
 
@@ -7,18 +7,18 @@
 
 На рисунке 1 приведена схема таблицы ```Series``` из четырех столбцов c именами ```SeriesId```, ```ReleaseDate```, ```SeriesInfo``` и ```Title``` и типами данных ```Uint64?``` для первых двух и ```String?``` для последних. Первичным ключом объявлен столбец ```SeriesId```.
 
-YDB использует типы данных [YQL]{% if audience != "external" %}(https://yql.yandex-team.ru/docs/ydb/types/){% else %}[](../../datatypes.md){% endif %}, в качестве типов столбцов могут использоваться {% if audience != "external" %} [простые типы данных YQL](https://yql.yandex-team.ru/docs/ydb/types/primitive/) {% else %} [простые типы данных YQL](../../../yql/reference/types/primitive.md) {% endif %} . Все столбцы могут содержать специальное значение NULL, используемое для обозначения отсутствия значения.
+{{ ydb-short-name }} использует типы данных [YQL]{% if audience != "external" %}(https://yql.yandex-team.ru/docs/ydb/types/){% else %}[](../../datatypes.md){% endif %}, в качестве типов столбцов могут использоваться {% if audience != "external" %} [простые типы данных YQL](https://yql.yandex-team.ru/docs/ydb/types/primitive/) {% else %} [простые типы данных YQL](../../../yql/reference/types/primitive.md) {% endif %} . Все столбцы могут содержать специальное значение NULL, используемое для обозначения отсутствия значения.
 
-Таблица YDB всегда имеет один или несколько столбцов, составляющих ключ ([primary key](https://en.wikipedia.org/wiki/Unique_key)). Строки таблицы уникальны по ключу, то есть для одного значения ключа может быть не больше одной строки. Таблица YDB всегда упорядочена по ключу. Это означает, что точечное чтение по ключу, а также диапазонные запросы по ключу или префиксу ключа выполняются эффективно (фактически используя индекс). В примере выше ключевые столбцы выделены серым цветом и отмечены специальным знаком. Допускаются таблицы, состоящие только из ключевых столбцов. Таблицы без первичного ключа создавать нельзя.
+Таблица {{ ydb-short-name }} всегда имеет один или несколько столбцов, составляющих ключ ([primary key](https://en.wikipedia.org/wiki/Unique_key)). Строки таблицы уникальны по ключу, то есть для одного значения ключа может быть не больше одной строки. Таблица {{ ydb-short-name }} всегда упорядочена по ключу. Это означает, что точечное чтение по ключу, а также диапазонные запросы по ключу или префиксу ключа выполняются эффективно (фактически используя индекс). В примере выше ключевые столбцы выделены серым цветом и отмечены специальным знаком. Допускаются таблицы, состоящие только из ключевых столбцов. Таблицы без первичного ключа создавать нельзя.
 
 Часто при проектировании схемы таблицы имеется набор полей, естественным образом подходящий для использования в качестве первичного ключа. Тем не менее, к выбору ключа нужно подходить аккуратно, чтобы не создать хотспоты.
-Например, если вы вставляете в таблицу данные с монотонно возрастающим ключом, то вы будете писать в конец таблицы. А так как YDB разбивает данные таблицы по диапазонам ключей, это означает, что ваши вставки будут обрабатываться одним конкретным сервером, и перестанут использоваться основные преимущества распределенной БД.
+Например, если вы вставляете в таблицу данные с монотонно возрастающим ключом, то вы будете писать в конец таблицы. А так как {{ ydb-short-name }} разбивает данные таблицы по диапазонам ключей, это означает, что ваши вставки будут обрабатываться одним конкретным сервером, и перестанут использоваться основные преимущества распределенной БД.
 Для того, чтобы нагрузка равномерно распределялась по различным серверам и при обработке больших таблиц не было хотспотов, рекомендуется применять: хэширование естественного ключа и использование хеша в качестве первой компоненты первичного ключа, изменение порядка следования компонент первичного ключа.
 
 ### Партиционирование таблиц {#partitioning}
 Таблица в БД может быть шардирована по диапазонам значений первичного ключа. Каждый шард таблицы отвечает за свой  диапазон первичных ключей. Диапазоны ключей, обслуживаемых разными шардами, не пересекаются. Различные шарды таблицы могут обслуживаться разными серверами распределенной БД (в том числе расположенными в разных локациях), а также могут независимо друг от друга перемещаться между серверами для перебалансировки или поддержания работоспособности шарда при отказах серверов или сетевого оборудования.
 
-При малом объеме данных или небольшой нагрузке таблица может состоять из одного шарда. При росте объема данных, обслуживаемых шардом, или нагрузки на шард, YDB автоматически разбивает его на два. Разбиение происходит по медианному значению первичного ключа, если размер шарда превышает порог. В случае разбиения по нагрузке шард сначала собирает сэмпл запрашиваемых ключей (читаемых, записываемых и удаляемых), и на основании этого сэмпла выбирает для разбиения такой ключ, чтоб нагрузка распределилась поровну между новыми шардами. Таким образом в случае разбиения по нагрузке новые шарды могут иметь существенно отличающийся размер.
+При малом объеме данных или небольшой нагрузке таблица может состоять из одного шарда. При росте объема данных, обслуживаемых шардом, или нагрузки на шард, {{ ydb-short-name }} автоматически разбивает его на два. Разбиение происходит по медианному значению первичного ключа, если размер шарда превышает порог. В случае разбиения по нагрузке шард сначала собирает сэмпл запрашиваемых ключей (читаемых, записываемых и удаляемых), и на основании этого сэмпла выбирает для разбиения такой ключ, чтоб нагрузка распределилась поровну между новыми шардами. Таким образом в случае разбиения по нагрузке новые шарды могут иметь существенно отличающийся размер.
 
 Порог разделения шарда по размеру и включение/выключение автоматического разделения могут быть настроены индивидуально для каждой таблицы базы данных.
 
@@ -26,7 +26,7 @@ YDB использует типы данных [YQL]{% if audience != "external"
 
 Параметры партиционирования относятся к самой таблице, но не к построенным на её данных вторичным индексам. Каждый индекс обслуживается своим набором шардов, и решения о разделении или объединении его партиций принимаются независимо на основании настроек по умолчанию. В будущем эти настройки могут быть сделаны доступными пользователям, аналогично настройкам основной таблицы.
 
-Характерное время операции разделения или объединения - порядка 500 милисекунд. На это время вовлеченные в операцию данные становятся кратковременно недоступны для чтения и записи. Специализированные методы-обертки в YDB SDK автоматически выполняют повторные попытки при получении информации о том, что шард находится в состоянии разделения или объединения, не поднимая её до уровня приложения. Стоит отметить, что если система по каким-то причинам перегружена (например, из-за общей нехватки CPU или пропускной способности выделенных базе дисковых ресурсов) то операции разделения и объединения могут длиться дольше. 
+Характерное время операции разделения или объединения - порядка 500 милисекунд. На это время вовлеченные в операцию данные становятся кратковременно недоступны для чтения и записи. Специализированные методы-обертки в {{ ydb-short-name }} SDK автоматически выполняют повторные попытки при получении информации о том, что шард находится в состоянии разделения или объединения, не поднимая её до уровня приложения. Стоит отметить, что если система по каким-то причинам перегружена (например, из-за общей нехватки CPU или пропускной способности выделенных базе дисковых ресурсов) то операции разделения и объединения могут длиться дольше. 
 
 В схеме данных определяются следующие параметры партиционирования таблицы:
 
@@ -88,7 +88,7 @@ YDB использует типы данных [YQL]{% if audience != "external"
 При включенном автоматическом партиционировании необходимо также не забыть установить корректное значение параметра [`AUTO_PARTITIONING_MIN_PARTITIONS_COUNT`](#auto_partitioning_min_partitions_count), чтобы все партиции не объединились в одну сразу после создания таблицы.
 
 ### Чтение с реплик {#read_only_replicas}
-При выполнении запросов в YDB фактическое выполнение запроса к каждому шарду осуществляется в единой точке, обслуживающей протокол распределенных транзакций. Но благодаря хранению данных на разделяемом хранилище возможен запуск одного или нескольких фолловеров шарда, без выделения дополнительного места на сторадже - данные уже хранятся реплицированного и возможно обслуживание более одного читателя (но писатель при этом всё еще в каждый момент строго один).
+При выполнении запросов в {{ ydb-short-name }} фактическое выполнение запроса к каждому шарду осуществляется в единой точке, обслуживающей протокол распределенных транзакций. Но благодаря хранению данных на разделяемом хранилище возможен запуск одного или нескольких фолловеров шарда, без выделения дополнительного места на сторадже - данные уже хранятся реплицированного и возможно обслуживание более одного читателя (но писатель при этом всё еще в каждый момент строго один).
 
 Применение чтения с фолловеров дает следующие возможности:
 * обслуживать клиентов, критичных к минимальным задержкам, недостижимым иными способами в мульти-ДЦ кластере. Достигается за счёт приближения точки выполнения запроса к точке задания запроса, что отсекает задержку на меж-ДЦ пересылки. В результате, сохраняя все гарантии мульти-ДЦ кластера по надёжности хранения, отвечать на точечные читающие запросы за единицы миллисекунд.
@@ -110,7 +110,7 @@ YDB использует типы данных [YQL]{% if audience != "external"
 
 ### Автоматическое удаление устаревших данных (TTL) {#ttl}
 
-YDB поддерживат функцию автоматического фонового удаления устаревших данных. В схеме данных таблицы может быть определена колонка, содержащая значение типа Datetime или Timestamp, значение которой у всех строк будет сравниваться в фоновом режиме с текущим временем. Строки, для которых текущее время стало больше чем значение в колонке с учетом заданной задержки, будут удалены.
+{{ ydb-short-name }} поддерживат функцию автоматического фонового удаления устаревших данных. В схеме данных таблицы может быть определена колонка, содержащая значение типа Datetime или Timestamp, значение которой у всех строк будет сравниваться в фоновом режиме с текущим временем. Строки, для которых текущее время стало больше чем значение в колонке с учетом заданной задержки, будут удалены.
 
 | Имя параметра | Тип | Допустимые значения | Возможность изменения | Возможность сброса |
 | ------------- | --- | ------------------- | --------------------- | ------------------ |
diff --git a/ydb/docs/ru/core/concepts/_includes/index/intro.md b/ydb/docs/ru/core/concepts/_includes/index/intro.md
index 44c7596058..3b47b7d27b 100644
--- a/ydb/docs/ru/core/concepts/_includes/index/intro.md
+++ b/ydb/docs/ru/core/concepts/_includes/index/intro.md
@@ -1,11 +1,11 @@
 ---
-title: Yandex Database (YDB). Обзор СУБД
-description: 'Yandex Database (YDB) — это горизонтально масштабируемая распределённая отказоустойчивая СУБД. YDB спроектирована с учетом требований высокой производительности — например, обычный сервер может обрабатывать десятки тысяч запросов в секунду. В дизайн системы заложена работа с объемами данных в сотни петабайт.'
+title: YDB. Обзор СУБД
+description: 'YDB — это горизонтально масштабируемая распределённая отказоустойчивая СУБД. YDB спроектирована с учетом требований высокой производительности — например, обычный сервер может обрабатывать десятки тысяч запросов в секунду. В дизайн системы заложена работа с объемами данных в сотни петабайт.'
 ---
 
-# Обзор Yandex Database (YDB)
+# Обзор {{ ydb-short-name }}
 
-*{{ ydb-full-name }}* ({{ ydb-short-name }}) — это горизонтально масштабируемая распределённая отказоустойчивая СУБД. {{ ydb-short-name }} спроектирована с учетом требований высокой производительности — например, обычный сервер может обрабатывать десятки тысяч запросов в секунду. В дизайн системы заложена работа с объемами данных в сотни петабайт. {{ ydb-short-name }} может эксплуатироваться в однодатацентровом и геораспределенном (кросс-датацентровый) режимах на кластере из тысяч серверов.
+*{{ ydb-short-name }}* ({{ ydb-short-name }}) — это горизонтально масштабируемая распределённая отказоустойчивая СУБД. {{ ydb-short-name }} спроектирована с учетом требований высокой производительности — например, обычный сервер может обрабатывать десятки тысяч запросов в секунду. В дизайн системы заложена работа с объемами данных в сотни петабайт. {{ ydb-short-name }} может эксплуатироваться в однодатацентровом и геораспределенном (кросс-датацентровый) режимах на кластере из тысяч серверов.
 
 {{ ydb-short-name }} обеспечивает:
 
@@ -15,7 +15,7 @@ description: 'Yandex Database (YDB) — это горизонтально мас
 * высокую доступность с автоматической обработкой отказов вычислительных узлов, стоек, или зон доступности;
 * автоматическое партицирование данных при увеличении их объема или увеличении нагрузки.
 
-Для взаимодействия с {{ ydb-short-name }} доступен [YDB CLI](../../../reference/ydb-cli/index.md), а также [SDK](../../../reference/ydb-sdk/index.md) для {% if oss %}C++,{% endif %}  Java, Python, Node.js, PHP и Go.
+Для взаимодействия с {{ ydb-short-name }} доступен [{{ ydb-short-name }} CLI](../../../reference/ydb-cli/index.md), а также [SDK](../../../reference/ydb-sdk/index.md) для {% if oss %}C++,{% endif %}  Java, Python, Node.js, PHP и Go.
 
 {{ ydb-short-name }} поддерживает реляционную [модель данных](../../../concepts/datamodel.md) и оперирует таблицами с предопределённой схемой. Для удобства организации таблиц поддерживается создание директорий по аналогии с файловой системой.
 
diff --git a/ydb/docs/ru/core/concepts/_includes/index/when_use.md b/ydb/docs/ru/core/concepts/_includes/index/when_use.md
index 5b117a2f91..9011747909 100644
--- a/ydb/docs/ru/core/concepts/_includes/index/when_use.md
+++ b/ydb/docs/ru/core/concepts/_includes/index/when_use.md
@@ -1,10 +1,10 @@
 ## Сценарии применения
 
-YDB является альтернативой имеющимся решениям в следующих случаях: 
+{{ ydb-short-name }} является альтернативой имеющимся решениям в следующих случаях: 
 * При использовании NoSQL систем, когда требуется строгая консистентность данных
 * При использовании NoSQL систем, когда требуется транзакционное изменение данных, хранящихся в разных строках одной или нескольких таблиц
 * В системах, требующих обработки и хранения большого объема данных, с возможностью практически неограниченного горизонтального масштабирования (в эксплуатации находятся промышленные кластера из 5000+ узлов, обрабатывающие нагрузку в миллионы RPS, и хранящие петабайты данных)
-* В системах с незначительной нагрузкой, когда поддержка отдельного инстанса базы данных будет расточительна с материальной точки зрения (предлагается использовать YDB в режиме бессерверных вычислений)
+* В системах с незначительной нагрузкой, когда поддержка отдельного инстанса базы данных будет расточительна с материальной точки зрения (предлагается использовать {{ ydb-short-name }} в режиме бессерверных вычислений)
 * В системах с плохо предсказуемой или сезонно меняющейся нагрузкой (используя возможность добавления/уменьшения вычислительных ресурсов по запросу и/или в
 режиме бессерверных вычислений)
 * В высоконагруженных системах, которые шардируют нагрузку между инстансами реляционной базы данных
diff --git a/ydb/docs/ru/core/concepts/_includes/limits-ydb.md b/ydb/docs/ru/core/concepts/_includes/limits-ydb.md
index f40e14a52a..1a8dca52a7 100644
--- a/ydb/docs/ru/core/concepts/_includes/limits-ydb.md
+++ b/ydb/docs/ru/core/concepts/_includes/limits-ydb.md
@@ -1,6 +1,6 @@
 # Ограничения базы данных
 
-В  разделе описаны параметры ограничений, установленных в YDB.
+В  разделе описаны параметры ограничений, установленных в {{ ydb-short-name }}.
 
 ## Ограничения объектов схемы
 
@@ -38,6 +38,6 @@
 | :--- | :--- | :--- | :--- | :---: |
 | Максимальное количество строк в результате запроса | 1000 | ExecuteDataQuery | Полные результаты некоторых запросов, выполненных через метод `ExecuteDataQuery`, могут содержать больше строк, чем допустимо. В этом случае в ответ на запрос вернётся максимально допустимое число строк, а у результата будет установлен флаг `truncated` | SUCCESS |
 | Максимальный размер результата запроса  | 50 Мб | ExecuteDataQuery | Полный результат некоторых запросов может превышать установленное ограничение. В этом случае запрос завершится ошибкой, данные не будут возвращены | PRECONDITION_FAILED |
-| Максимальное количество сессий на ноду кластера  | 1000 | CreateSession | Используя библиотеку для работы с YDB, приложение может создавать сессии в рамках соединения. Сессии привязаны к ноде. С одной нодой можно создать ограниченное количество сессий | OVERLOADED |
+| Максимальное количество сессий на ноду кластера  | 1000 | CreateSession | Используя библиотеку для работы с {{ ydb-short-name }}, приложение может создавать сессии в рамках соединения. Сессии привязаны к ноде. С одной нодой можно создать ограниченное количество сессий | OVERLOADED |
 | Максимальная длина текста запроса | 10 Кб | ExecuteDataQuery | Ограничение на длину текста YQL-запроса  | BAD_REQUEST |
 | Максимальный размер значений параметров | 50 Мб | ExecuteDataQuery | Ограничение на суммарный размер параметров, передаваемых при выполнении ранее подготовленного запроса  | BAD_REQUEST |
diff --git a/ydb/docs/ru/core/concepts/_includes/scan_query.md b/ydb/docs/ru/core/concepts/_includes/scan_query.md
index a228152768..fa2ee180b7 100644
--- a/ydb/docs/ru/core/concepts/_includes/scan_query.md
+++ b/ydb/docs/ru/core/concepts/_includes/scan_query.md
@@ -1,4 +1,4 @@
-# Скан запросы (Scan Query) в Yandex Database
+# Скан запросы (Scan Query) в {{ ydb-short-name }}
 
 Скан запросы (*Scan Queries*) - это отдельный интерфейс доступа к данным, предназначенный в первую очередь для выполнения аналитических ad-hoc запросов над базой данных.
 
diff --git a/ydb/docs/ru/core/concepts/_includes/serverless_and_dedicated/01_intro.md b/ydb/docs/ru/core/concepts/_includes/serverless_and_dedicated/01_intro.md
index d6500eaa9b..3ca78baf0b 100644
--- a/ydb/docs/ru/core/concepts/_includes/serverless_and_dedicated/01_intro.md
+++ b/ydb/docs/ru/core/concepts/_includes/serverless_and_dedicated/01_intro.md
@@ -1,5 +1,5 @@
 ---
-title: Режимы работы Serverless и Dedicated в Yandex Database
+title: Режимы работы Serverless и Dedicated в YDB
 description: "Базы YDB могут быть созданы в двух режимах Dedicated и Serverless. Режим работы Dedicated предполагает, что ресурсы на инстансы Таблеток и на выполнение YQL-запросов выбираются из явно выделенных для базы данных compute ресурсов. В Serverless режиме работы инфраструктура YDB определяет сколько вычислительных ресурсов необходимо выделить для обслуживания пользовательской базы."
 keywords:
   - ydb
@@ -8,7 +8,7 @@ keywords:
 editable: false
 ---
 
-# Serverless и Dedicated режимы работы {{ ydb-full-name }}
+# Serverless и Dedicated режимы работы {{ ydb-short-name }}
 
 Вы можете создать и использовать множество баз данных {{ ydb-short-name }}. Для каждой БД при создании выбирается один из двух режимов работы: Serverless или Dedicated. В дальнейшем он не может быть изменен.
 
diff --git a/ydb/docs/ru/core/concepts/_includes/serverless_and_dedicated/02_sls_pars.md b/ydb/docs/ru/core/concepts/_includes/serverless_and_dedicated/02_sls_pars.md
index 440f36e1a9..b8ffd6519d 100644
--- a/ydb/docs/ru/core/concepts/_includes/serverless_and_dedicated/02_sls_pars.md
+++ b/ydb/docs/ru/core/concepts/_includes/serverless_and_dedicated/02_sls_pars.md
@@ -7,7 +7,7 @@
 
 Так как ресурсы Serverless базы данных неопределенно большие, то и максимальное потребление Request Units за промежуток времени также может составить любое значение, приведя к нежелательным начислениям. Например, такое может произойти в результате ошибки в коде, приводящей к запросам в бесконечном цикле.
 
-При облачном развертывании YDB на уровне облачных квот существует ограничение на общее количество Request Units в секунду. Но данное ограничение носит технический характер, и достаточно велико, чтобы возможная сумма счета оказалась заметно выше ожиданий. Изменение этого параметра возможно только в сторону увеличения через обращение в техническую поддержку.
+При облачном развертывании {{ ydb-short-name }} на уровне облачных квот существует ограничение на общее количество Request Units в секунду. Но данное ограничение носит технический характер, и достаточно велико, чтобы возможная сумма счета оказалась заметно выше ожиданий. Изменение этого параметра возможно только в сторону увеличения через обращение в техническую поддержку.
 
 Ограничение **Пропускная способность** на Serverless базе данных позволяет вам установить максимальную скорость потребления RU в секунду. С учетом 5 минутного накопления неиспользованных RU, небольшие величины этого ограничения (10 RU/с — значение по умолчанию при создании БД) позволяют успешно осуществлять широкий круг задач разработки и тестирования, а также эксплуатировать приложения с небольшой нагрузкой. При этом величина возможных начислений будет ограничена верхней границей в 2572000 секунд в месяц (30 дней), умноженной на цену за 1 миллион RU. По тарифу, актуальному на момент написания этой документации (13.36 ₽), максимально возможная сумма начислений в месяц составит около 340 ₽.
 
diff --git a/ydb/docs/ru/core/concepts/_includes/serverless_and_dedicated/10_arch_diff.md b/ydb/docs/ru/core/concepts/_includes/serverless_and_dedicated/10_arch_diff.md
index 10d860d31f..1befb52c99 100644
--- a/ydb/docs/ru/core/concepts/_includes/serverless_and_dedicated/10_arch_diff.md
+++ b/ydb/docs/ru/core/concepts/_includes/serverless_and_dedicated/10_arch_diff.md
@@ -3,18 +3,18 @@
 
 ### Разделение compute и storage слоев {#separate-layers}
 
-Важно понимать, что в YDB явно выделены слои storage и compute. Storage слой отвечает за надежное хранение данных на устройствах хранения и репликацию данных между узлами для обеспечения отказоустойчивости.
+Важно понимать, что в {{ ydb-short-name }} явно выделены слои storage и compute. Storage слой отвечает за надежное хранение данных на устройствах хранения и репликацию данных между узлами для обеспечения отказоустойчивости.
 
-В YDB данные пользователя хранятся в таблицах, таблицы партицированы. Шард — это сущность, которая отвечает за хранение партиции таблицы (обычно, одной). За изменение данных в шарде отвечает такая сущность как Таблетка — это компонент, реализующий согласованное изменение данных в шарде и решающий проблему распределенного консенсуса. На инстанс таблетки можно смотреть как на объект, который порожден в адресном пространстве процесса и потребляет процессорные ресурсы и оперативную память. Все свое состояние Таблетка хранит в storage слое. Это, в том числе, означает, что инстанс Таблетки может быть поднят в произвольном процессе, откуда доступен storage слой. Compute слой YDB по сути состоит из Таблеток и слоя выполнения YQL-запросов.
+В {{ ydb-short-name }} данные пользователя хранятся в таблицах, таблицы партицированы. Шард — это сущность, которая отвечает за хранение партиции таблицы (обычно, одной). За изменение данных в шарде отвечает такая сущность как Таблетка — это компонент, реализующий согласованное изменение данных в шарде и решающий проблему распределенного консенсуса. На инстанс таблетки можно смотреть как на объект, который порожден в адресном пространстве процесса и потребляет процессорные ресурсы и оперативную память. Все свое состояние Таблетка хранит в storage слое. Это, в том числе, означает, что инстанс Таблетки может быть поднят в произвольном процессе, откуда доступен storage слой. Compute слой {{ ydb-short-name }} по сути состоит из Таблеток и слоя выполнения YQL-запросов.
 
 Стоит отметить, что понятие базы данных состоит не только из пользовательских таблиц и, соответственно, Таблеток обслуживающих эти таблицы, но и определенных системных сущностей. Например, есть Таблетка SchemeShard, которая обслуживает схему данных всех таблиц, есть система координации распределенных транзакций, элементы которых также представляют собой Таблетки.
 
-### Dedicated режим работы YDB {#dedicated}
+### Dedicated режим работы {{ ydb-short-name }} {#dedicated}
 
-Режим работы Dedicated предполагает, что ресурсы на инстансы Таблеток и на выполнение YQL-запросов выбираются из явно выделенных для базы данных compute ресурсов. Под compute ресурсами понимаются виртуальные машины, обладаемые определенным количеством vCPU и памяти. Задача выбора оптимального количества ресурсов для базы данных в настоящий момент лежит на пользователе. Если ресурсов будет недостаточно для обслуживания подаваемой нагрузки, то latency запросов начнет увеличиваться, а в пределе будет отказ в обслуживании запросов, например с кодом возврата ```OVERLOADED```. Пользователь может добавить compute ресурсы (ВМ) в базу данных в UI или CLI для того, чтобы обеспечить базу данных необходимым количеством вычислительных ресурсов. Добавление compute ресурсов в базу данных происходит относительно быстро и сопоставимо со временем запуска ВМ. Далее YDB автоматически отбалансирует Таблетки по кластеру с учетом добавленных ресурсов.
+Режим работы Dedicated предполагает, что ресурсы на инстансы Таблеток и на выполнение YQL-запросов выбираются из явно выделенных для базы данных compute ресурсов. Под compute ресурсами понимаются виртуальные машины, обладаемые определенным количеством vCPU и памяти. Задача выбора оптимального количества ресурсов для базы данных в настоящий момент лежит на пользователе. Если ресурсов будет недостаточно для обслуживания подаваемой нагрузки, то latency запросов начнет увеличиваться, а в пределе будет отказ в обслуживании запросов, например с кодом возврата ```OVERLOADED```. Пользователь может добавить compute ресурсы (ВМ) в базу данных в UI или CLI для того, чтобы обеспечить базу данных необходимым количеством вычислительных ресурсов. Добавление compute ресурсов в базу данных происходит относительно быстро и сопоставимо со временем запуска ВМ. Далее {{ ydb-short-name }} автоматически отбалансирует Таблетки по кластеру с учетом добавленных ресурсов.
 
-### Serverless режим работы YDB {#serverless}
+### Serverless режим работы {{ ydb-short-name }} {#serverless}
 
-В Serverless режиме работы инфраструктура YDB определяет сколько вычислительных ресурсов необходимо выделить для обслуживания пользовательской базы. Количество выделенных ресурсов может быть как очень большим (произвольное количество ядер), так и очень маленьким (значительно менее одного ядра). Если пользователь создал базу данных из одной таблицы с одной записью в ней, при этом выполняет запросы к базе крайне редко, то YDB по сути тратит незначительный объем памяти на инстансы Таблеток, которые входят в состав пользовательской базы. Это возможно за счет того, что компоненты пользовательской базы представляют собой объекты, а не процессы. Если нагрузка возрастает, то компоненты базы начинают потреблять больше процессорного времени и памяти. Если нагрузка возратает до пределов, когда ресурсов ВМ не хватает, инфраструктура YDB имеет возможность гранулированно балансировать систему, порождая инстансы Таблеток на других ВМ.
+В Serverless режиме работы инфраструктура {{ ydb-short-name }} определяет сколько вычислительных ресурсов необходимо выделить для обслуживания пользовательской базы. Количество выделенных ресурсов может быть как очень большим (произвольное количество ядер), так и очень маленьким (значительно менее одного ядра). Если пользователь создал базу данных из одной таблицы с одной записью в ней, при этом выполняет запросы к базе крайне редко, то {{ ydb-short-name }} по сути тратит незначительный объем памяти на инстансы Таблеток, которые входят в состав пользовательской базы. Это возможно за счет того, что компоненты пользовательской базы представляют собой объекты, а не процессы. Если нагрузка возрастает, то компоненты базы начинают потреблять больше процессорного времени и памяти. Если нагрузка возратает до пределов, когда ресурсов ВМ не хватает, инфраструктура {{ ydb-short-name }} имеет возможность гранулированно балансировать систему, порождая инстансы Таблеток на других ВМ.
 
 Подобная технология позволяет очень плотно упаковывать виртуальные сущности (инстансы Таблеток) в физические ресурсы на основе реального потребления, что дает возможность выставлять счет пользователю за выполненные операции, а не за выделенные ресурсы.
 \ No newline at end of file
diff --git a/ydb/docs/ru/core/concepts/_includes/transactions.md b/ydb/docs/ru/core/concepts/_includes/transactions.md
index f565579513..12c14885ee 100644
--- a/ydb/docs/ru/core/concepts/_includes/transactions.md
+++ b/ydb/docs/ru/core/concepts/_includes/transactions.md
@@ -1,12 +1,12 @@
-# Транзакции и запросы к YDB
+# Транзакции и запросы к {{ ydb-short-name }}
 
-Этот раздел описывает особенности реализации YQL для YDB транзакций.
+Этот раздел описывает особенности реализации YQL для {{ ydb-short-name }} транзакций.
 
 ## Язык запросов
-Основным средством создания, модификации и управления данными в YDB является декларативный язык запросов YQL. YQL — это диалект SQL, который может считаться стандартом для общения с базами данных. Кроме того YDB поддерживает набор специальных RPC, например, для работы с древовидной схемой или для управления кластером.
+Основным средством создания, модификации и управления данными в {{ ydb-short-name }} является декларативный язык запросов YQL. YQL — это диалект SQL, который может считаться стандартом для общения с базами данных. Кроме того {{ ydb-short-name }} поддерживает набор специальных RPC, например, для работы с древовидной схемой или для управления кластером.
 
 ## Режимы транзакций {#modes}
-По умолчанию транзакции в YDB выполняются в режиме *Serializable*, который предоставляет самый строгий [уровень изоляции](https://en.wikipedia.org/wiki/Isolation_(database_systems)#Serializable) для пользовательских транзакций. В этом режиме гарантируется, что результат успешно выполненных параллельных транзакций эквивалентен определенному последовательному порядку их выполнения, при этом для успешных транзакций отсутствуют [аномалии чтений](https://en.wikipedia.org/wiki/Isolation_(database_systems)#Read_phenomena).
+По умолчанию транзакции в {{ ydb-short-name }} выполняются в режиме *Serializable*, который предоставляет самый строгий [уровень изоляции](https://en.wikipedia.org/wiki/Isolation_(database_systems)#Serializable) для пользовательских транзакций. В этом режиме гарантируется, что результат успешно выполненных параллельных транзакций эквивалентен определенному последовательному порядку их выполнения, при этом для успешных транзакций отсутствуют [аномалии чтений](https://en.wikipedia.org/wiki/Isolation_(database_systems)#Read_phenomena).
 
 В случае когда требования консистентности или свежести читаемых транзакцией данных могут быть ослаблены, пользователь имеет возможность использовать режимы выполнения с пониженными гарантиями:
 * *Online Read-Only*. Каждое из чтений в транзакции читает последние на момент своего выполнения данные. Консистентость полученных данных определяется настройкой *allow_inconsistent_reads*:
@@ -22,11 +22,11 @@
 
 Подробнее о поддерживаемых конструкциях YQL можно почитать в [документации YQL](../../yql/reference/index.md).
 
-Ниже перечислены возможности и ограничения поддержки YQL в YDB, которые могут быть неочевидны на первый взгляд и на которые стоит обратить внимание.
+Ниже перечислены возможности и ограничения поддержки YQL в {{ ydb-short-name }}, которые могут быть неочевидны на первый взгляд и на которые стоит обратить внимание.
 
  * Допускаются multistatement transactions, то есть транзакции, состоящие из последовательности выражений YQL. При выполнении транзакции допускается взаимодействие с клиентской программой, иначе говоря, взаимодействие клиента с базой может выглядеть следующим образом: `BEGIN; выполнить SELECT; проанализировать результаты SELECT на клиенте; ...; выполнить UPDATE; COMMIT`. Стоит отметить, что если тело транзакции полностью сформировано до обращения к базе данных, то транзакция может обрабатываться эффективнее.
- * В YDB не поддерживается возможность смешивать DDL и DML запросы в одной транзакции. Традиционное понятие [ACID](https://ru.wikipedia.org/wiki/ACID) транзакции применимо именно к DML запросам, то есть к запросам, которые меняют данные. DDL запросы должны быть идемпотентными, то есть повторяемы в случае ошибки. Если необходимо выполнить действие со схемой, то каждое из действий будет транзакционно, а набор действий - нет.
- * Реализация YQL в YDB использует механизм [Optimistic Concurrency Control](https://en.wikipedia.org/wiki/Optimistic_concurrency_control). На затронутые в ходе транзакции сущности ставятся оптимистичные блокировки, при завершении транзакции проверяется, что блокировки не были инвалидированы. Оптимистичность блокировок выливается в важное для пользователя свойство — в случае конфликта выигрывает транзакция, которая завершается первой. Конкурирующие транзакции завершатся с ошибкой ```Transaction locks invalidated```.
+ * В {{ ydb-short-name }} не поддерживается возможность смешивать DDL и DML запросы в одной транзакции. Традиционное понятие [ACID](https://ru.wikipedia.org/wiki/ACID) транзакции применимо именно к DML запросам, то есть к запросам, которые меняют данные. DDL запросы должны быть идемпотентными, то есть повторяемы в случае ошибки. Если необходимо выполнить действие со схемой, то каждое из действий будет транзакционно, а набор действий - нет.
+ * Реализация YQL в {{ ydb-short-name }} использует механизм [Optimistic Concurrency Control](https://en.wikipedia.org/wiki/Optimistic_concurrency_control). На затронутые в ходе транзакции сущности ставятся оптимистичные блокировки, при завершении транзакции проверяется, что блокировки не были инвалидированы. Оптимистичность блокировок выливается в важное для пользователя свойство — в случае конфликта выигрывает транзакция, которая завершается первой. Конкурирующие транзакции завершатся с ошибкой ```Transaction locks invalidated```.
  * Все изменения, производимые в рамках транзакции, накапливаются в памяти сервера базы данных и применяются в момент завершения транзакции. Если взятые блокировки не были инвалидированы, то все накопленные изменения применяются атомарно, если хотя бы одна блокировка была инвалидирована, то ни одно из изменений не будет применено. Описанная схема накладывает некоторые ограничения: объем изменений осуществляемых в рамках одной транзакции должен умещаться в память и транзакция "не видит" своих изменений.
 
 Следует формировать транзакцию таким образом, чтобы в первой части транзакции выполнялись только чтения, а во второй части транзакции только модификации. Структура запроса тогда выглядит следующим образом:
@@ -39,10 +39,10 @@
        COMMIT;
 ```
 
-Подробнее о поддержке YQL в YDB можно прочитать в [документации YQL](../../yql/reference/index.md).
+Подробнее о поддержке YQL в {{ ydb-short-name }} можно прочитать в [документации YQL](../../yql/reference/index.md).
 
 ## Распределенные транзакции {#distributed-tx}
 
-Таблица в YDB может быть шардирована по диапазонам значений первичного ключа. Различные шарды таблицы могут обслуживаться разными серверами распределенной БД (в том числе расположенными в разных локациях), а также могут независимо друг от друга перемещаться между серверами для перебалансировки или поддержания работоспособности шарда при отказах серверов или сетевого оборудования.
+Таблица в {{ ydb-short-name }} может быть шардирована по диапазонам значений первичного ключа. Различные шарды таблицы могут обслуживаться разными серверами распределенной БД (в том числе расположенными в разных локациях), а также могут независимо друг от друга перемещаться между серверами для перебалансировки или поддержания работоспособности шарда при отказах серверов или сетевого оборудования.
 
-В YDB поддерживаются распределенные транзакции. Распределенные транзакции — это транзакции, которые затрагивают более одного шарда одной или нескольких таблиц. Они требуют больше ресурсов и выполняются дольше. В то время как точечные чтения и записи могут выполняться за время до 10 мс в 99 перцентиле, распределенные транзакции, как правило, занимают от 20 до 500 мс.
+В {{ ydb-short-name }} поддерживаются распределенные транзакции. Распределенные транзакции — это транзакции, которые затрагивают более одного шарда одной или нескольких таблиц. Они требуют больше ресурсов и выполняются дольше. В то время как точечные чтения и записи могут выполняться за время до 10 мс в 99 перцентиле, распределенные транзакции, как правило, занимают от 20 до 500 мс.
diff --git a/ydb/docs/ru/core/concepts/cluster/_includes/common_scheme_ydb/intro.md b/ydb/docs/ru/core/concepts/cluster/_includes/common_scheme_ydb/intro.md
index b941184345..6b8877ca06 100644
--- a/ydb/docs/ru/core/concepts/cluster/_includes/common_scheme_ydb/intro.md
+++ b/ydb/docs/ru/core/concepts/cluster/_includes/common_scheme_ydb/intro.md
@@ -1,5 +1,5 @@
-# Общая схема YDB
+# Общая схема {{ ydb-short-name }}
 
-Примерная общая схема YDB показана ниже.
+Примерная общая схема {{ ydb-short-name }} показана ниже.
 
 ![Общая схема](../../_assets/BS_overview.svg)
diff --git a/ydb/docs/ru/core/concepts/cluster/_includes/common_scheme_ydb/nodes.md b/ydb/docs/ru/core/concepts/cluster/_includes/common_scheme_ydb/nodes.md
index 64fa37d335..dc5e52f6fd 100644
--- a/ydb/docs/ru/core/concepts/cluster/_includes/common_scheme_ydb/nodes.md
+++ b/ydb/docs/ru/core/concepts/cluster/_includes/common_scheme_ydb/nodes.md
@@ -1,6 +1,6 @@
 ## Узлы
 
-Одна инсталляция YDB состоит из *кластера*, который разбит на *узлы*. Узел -- это один процесс в системе, как правило kikimr. Это узел входит в кластер и может обмениваться данными с другими узлами в этом кластере через *Interconnect*. Каждый *узел* имеет свой идентификатор, который обычно называется NodeId. NodeId -- целое число от 1, состоит из 20 бит. NodeId 0 зарезервирован для внутренних нужд и как правило обозначает текущий узел, либо отсутствие узла.
+Одна инсталляция {{ ydb-short-name }} состоит из *кластера*, который разбит на *узлы*. Узел -- это один процесс в системе, как правило kikimr. Это узел входит в кластер и может обмениваться данными с другими узлами в этом кластере через *Interconnect*. Каждый *узел* имеет свой идентификатор, который обычно называется NodeId. NodeId -- целое число от 1, состоит из 20 бит. NodeId 0 зарезервирован для внутренних нужд и как правило обозначает текущий узел, либо отсутствие узла.
 
 На каждом узле выполняется ряд сервисов, реализованных через *акторы*.
 
@@ -8,4 +8,4 @@
 
 Конфигурация статических узлов, то есть их полный перечень с указанием адреса для подключения по Interconnect, хранится в конфигурационном файле и вычитывается единожды при запуске процесса. Набор статических узлов меняется очень редко. Как правило, это происходит при расширении кластеров или при переезде узлов с одних физических машин на другие. Для того, чтобы изменить набор статических узлов, нужно разложить на **всех** узлах обновлённую конфигурацию, после чего выполнить rolling restart всего кластера.
 
-Динамические узлы заранее неизвестны и добавляются в систему по мере запуска новых процессов. Это может быть связано, например, с созданием новых тенантов в инсталляциях YDB как БД. При регистрации динамического узла его процесс сначала подключается к одному из статических узлов через gRPC и через специальный сервис, который называется Node Broker, передаёт информацию о себе, получая в ответ NodeId, под которым ему можно будет войти в систему. Механизм назначения узлов во многом похож на DHCP в контексте раздачи IP-адресов.
+Динамические узлы заранее неизвестны и добавляются в систему по мере запуска новых процессов. Это может быть связано, например, с созданием новых тенантов в инсталляциях {{ ydb-short-name }} как БД. При регистрации динамического узла его процесс сначала подключается к одному из статических узлов через gRPC и через специальный сервис, который называется Node Broker, передаёт информацию о себе, получая в ответ NodeId, под которым ему можно будет войти в систему. Механизм назначения узлов во многом похож на DHCP в контексте раздачи IP-адресов.
diff --git a/ydb/docs/ru/core/concepts/cluster/_includes/distributed_storage/intro.md b/ydb/docs/ru/core/concepts/cluster/_includes/distributed_storage/intro.md
index a70bbb9e24..aee5247334 100644
--- a/ydb/docs/ru/core/concepts/cluster/_includes/distributed_storage/intro.md
+++ b/ydb/docs/ru/core/concepts/cluster/_includes/distributed_storage/intro.md
@@ -1,5 +1,5 @@
-# Дисковая подсистема кластера aka YDB BlobStorage
+# Дисковая подсистема кластера aka {{ ydb-short-name }} BlobStorage
 
-YDB BlobStorage -- подсистема YDB, которая отвечает за надёжное хранение данных.
+{{ ydb-short-name }} BlobStorage -- подсистема {{ ydb-short-name }}, которая отвечает за надёжное хранение данных.
 
 Позволяет хранить *блобы* (бинарный фрагмент размером от 1 байта до 10 мегабайт) c уникальным идентификатором.
diff --git a/ydb/docs/ru/core/concepts/cluster/index.md b/ydb/docs/ru/core/concepts/cluster/index.md
index 13c681d0e8..561f540a32 100644
--- a/ydb/docs/ru/core/concepts/cluster/index.md
+++ b/ydb/docs/ru/core/concepts/cluster/index.md
@@ -1,7 +1,7 @@
-# Кластер YDB
+# Кластер {{ ydb-short-name }}
 
-Информация в данном разделе в основном предназначена для администраторов и разработчиков YDB.
+Информация в данном разделе в основном предназначена для администраторов и разработчиков {{ ydb-short-name }}.
 
-В статье ["Общая схема YDB"](common_scheme_ydb.md) представлена общая информация об узлах и таблетках.
+В статье ["Общая схема {{ ydb-short-name }}"](common_scheme_ydb.md) представлена общая информация об узлах и таблетках.
 
-В статье ["Дисковая подсистема кластера"](distributed_storage.md) можно подробнее ознакомиться с особенностями распределенной системы хранения YDB.
+В статье ["Дисковая подсистема кластера"](distributed_storage.md) можно подробнее ознакомиться с особенностями распределенной системы хранения {{ ydb-short-name }}.
diff --git a/ydb/docs/ru/core/deploy/configuration/config.md b/ydb/docs/ru/core/deploy/configuration/config.md
index 5be44a6618..c4019863f6 100644
--- a/ydb/docs/ru/core/deploy/configuration/config.md
+++ b/ydb/docs/ru/core/deploy/configuration/config.md
@@ -1,7 +1,7 @@
 # Создание конфигурации для развертывания кластера
 
-Для того, чтобы развернуть кластер {{ ydb-full-name }} необходимо создать конфигурацию кластера.
-В данном разделе описывается процесс создание конфигурации кластера {{ ydb-full-name }} в YAML формате.
+Для того, чтобы развернуть кластер {{ ydb-short-name }} необходимо создать конфигурацию кластера.
+В данном разделе описывается процесс создание конфигурации кластера {{ ydb-short-name }} в YAML формате.
 
 ## Описание конфигурации хостов хранилища
 
diff --git a/ydb/docs/ru/core/deploy/orchestrated/_includes/ydb-kubernetes-operator.md b/ydb/docs/ru/core/deploy/orchestrated/_includes/ydb-kubernetes-operator.md
index 395b34a013..f23b18ceb1 100644
--- a/ydb/docs/ru/core/deploy/orchestrated/_includes/ydb-kubernetes-operator.md
+++ b/ydb/docs/ru/core/deploy/orchestrated/_includes/ydb-kubernetes-operator.md
@@ -1,8 +1,8 @@
 # Установка кластера
 
-## Установите контроллер {{ ydb-name }} в кластер {#install-ydb-controller}
+## Установите контроллер {{ ydb-short-name }} в кластер {#install-ydb-controller}
 
-Установите {{ ydb-name }} в стандартной конфигурации:
+Установите {{ ydb-short-name }} в стандартной конфигурации:
 
 {% list tabs %}
 
@@ -30,7 +30,7 @@
 
 {% endlist %}
 
-## Создайте кластер {{ ydb-name }} {#create-cluster}
+## Создайте кластер {{ ydb-short-name }} {#create-cluster}
 
 Примените манифест для создания кластера {{ ydb-short-name }}:
 
@@ -140,7 +140,7 @@
 
 ## Проверьте работу {#test-ydb}
 
-Проверьте работоспособность {{ ydb-name }}:
+Проверьте работоспособность {{ ydb-short-name }}:
 
 {% list tabs %}
 
@@ -222,7 +222,7 @@
       kubectl delete pvc -l app.kubernetes.io/name=ydb
       ```
 
-  1. Чтобы удалить контроллер {{ ydb-name }} из кластера {{ k8s }}, удалите релиз, созданный Helm:
+  1. Чтобы удалить контроллер {{ ydb-short-name }} из кластера {{ k8s }}, удалите релиз, созданный Helm:
 
       ```bash
       helm delete ydb-operator
diff --git a/ydb/docs/ru/core/deploy/orchestrated/aws_eks.md b/ydb/docs/ru/core/deploy/orchestrated/aws_eks.md
index ca5f95f994..9b6b7e843d 100644
--- a/ydb/docs/ru/core/deploy/orchestrated/aws_eks.md
+++ b/ydb/docs/ru/core/deploy/orchestrated/aws_eks.md
@@ -1,6 +1,6 @@
-# Развертывание {{ ydb-name }} в AWS EKS
+# Развертывание {{ ydb-short-name }} в AWS EKS
 
-Чтобы с помощью [{{ k8s }}](https://kubernetes.io/) создать кластер [{{ ydb-name }}](https://cloud.yandex.ru/docs/ydb/), выполните следующие действия.
+Чтобы с помощью [{{ k8s }}](https://kubernetes.io/) создать кластер [{{ ydb-short-name }}](https://cloud.yandex.ru/docs/ydb/), выполните следующие действия.
 
 ## Перед началом работы {#before-begin}
 
diff --git a/ydb/docs/ru/core/deploy/orchestrated/concepts.md b/ydb/docs/ru/core/deploy/orchestrated/concepts.md
index 02dc876fb2..26722e6ab3 100644
--- a/ydb/docs/ru/core/deploy/orchestrated/concepts.md
+++ b/ydb/docs/ru/core/deploy/orchestrated/concepts.md
@@ -1,6 +1,6 @@
 # Обзор
 
-Развертывание {{ ydb-name }} в {{ k8s }} — это простой и доступный способ установки {{ ydb-name }}. С {{ k8s }} вы можете использовать универсальный подход к управлению приложением в любом облачном провайдере. Это руководство содержит инструкции для развертывания {{ ydb-short-name }} в [{{ managed-k8s-full-name}}](yc_managed_kubernetes.md) и [AWS EKS](aws_eks.md).
+Развертывание {{ ydb-short-name }} в {{ k8s }} — это простой и доступный способ установки {{ ydb-short-name }}. С {{ k8s }} вы можете использовать универсальный подход к управлению приложением в любом облачном провайдере. Это руководство содержит инструкции для развертывания {{ ydb-short-name }} в [{{ managed-k8s-full-name}}](yc_managed_kubernetes.md) и [AWS EKS](aws_eks.md).
 
 {{ ydb-short-name }} поставляется в виде Helm-чарта — пакета, который содержит шаблоны структур {{ k8s }}. Чарт может быть развернут в следующем окружении:
 
@@ -11,7 +11,7 @@
 
 Подробнее о Helm читайте в [документации](https://helm.sh/ru/docs/).
 
-Helm-чарт устанавливает в кластер {{ k8s }} контроллер, который реализует необходимую логику для развертывания компонентов {{ ydb-name }}. Контроллер построен по паттерну [Оператор](https://kubernetes.io/docs/concepts/extend-kubernetes/operator/).
+Helm-чарт устанавливает в кластер {{ k8s }} контроллер, который реализует необходимую логику для развертывания компонентов {{ ydb-short-name }}. Контроллер построен по паттерну [Оператор](https://kubernetes.io/docs/concepts/extend-kubernetes/operator/).
 
 {{ydb-short-name}} состоит из двух компонентов:
 
diff --git a/ydb/docs/ru/core/deploy/orchestrated/operate.md b/ydb/docs/ru/core/deploy/orchestrated/operate.md
index fa2a64d455..6c3d0ab814 100644
--- a/ydb/docs/ru/core/deploy/orchestrated/operate.md
+++ b/ydb/docs/ru/core/deploy/orchestrated/operate.md
@@ -1,4 +1,4 @@
-# Эксплуатация {{ ydb-name }} в {{ k8s }}
+# Эксплуатация {{ ydb-short-name }} в {{ k8s }}
 
 ## Мониторинг
 
diff --git a/ydb/docs/ru/core/deploy/orchestrated/yc_managed_kubernetes.md b/ydb/docs/ru/core/deploy/orchestrated/yc_managed_kubernetes.md
index 728a2076d1..8c8b0c51a0 100644
--- a/ydb/docs/ru/core/deploy/orchestrated/yc_managed_kubernetes.md
+++ b/ydb/docs/ru/core/deploy/orchestrated/yc_managed_kubernetes.md
@@ -1,6 +1,6 @@
-# Развертывание {{ ydb-name }} в {{ managed-k8s-name }}
+# Развертывание {{ ydb-short-name }} в {{ managed-k8s-name }}
 
-Чтобы с помощью [{{ k8s }}](https://kubernetes.io/) создать кластер [{{ ydb-name }}](https://cloud.yandex.ru/docs/ydb/), выполните следующие действия.
+Чтобы с помощью [{{ k8s }}](https://kubernetes.io/) создать кластер [{{ ydb-short-name }}](https://cloud.yandex.ru/docs/ydb/), выполните следующие действия.
 
 ## Перед началом работы {#before-begin}
 
diff --git a/ydb/docs/ru/core/faq/_includes/common.md b/ydb/docs/ru/core/faq/_includes/common.md
index adca928c19..6e68487724 100644
--- a/ydb/docs/ru/core/faq/_includes/common.md
+++ b/ydb/docs/ru/core/faq/_includes/common.md
@@ -1,21 +1,21 @@
 ---
-title: "Yandex Database. Ответы на вопросы"
-description: "Что такое Yandex Database? Для каких задач стоит использовать Yandex Database, а для каких виртуальные машины с базами данных? Какую часть работы по управлению и сопровождению баз данных берет на себя Yandex Database? Ответы на эти и другие вопросы в данной статье."
+title: "YDB. Ответы на вопросы"
+description: "Что такое YDB? Для каких задач стоит использовать YDB, а для каких виртуальные машины с базами данных? Какую часть работы по управлению и сопровождению баз данных берет на себя YDB? Ответы на эти и другие вопросы в данной статье."
 ---
 
-# Общие вопросы про {{ ydb-name }}
+# Общие вопросы про {{ ydb-short-name }}
 
 #### Что такое {{ ydb-short-name }}? {#what-is-ydb}
 
-{{ ydb-short-name }} — это распределенная отказоустойчивая Distributed SQL СУБД. YDB обеспечивает высокую доступность и масштабируемость, и, в то же время, строгую консистентность и поддержку ACID-транзакций. Для запросов используется диалект SQL (YQL).
+{{ ydb-short-name }} — это распределенная отказоустойчивая Distributed SQL СУБД. {{ ydb-short-name }} обеспечивает высокую доступность и масштабируемость, и, в то же время, строгую консистентность и поддержку ACID-транзакций. Для запросов используется диалект SQL (YQL).
 
 {{ ydb-short-name }} — это полностью управляемая база данных, для создания инстанса базы данных используется сервис управления базами данных {{ ydb-short-name }}.
 
 #### Какие возможности предоставляет {{ ydb-short-name }}? {#ydb-features}
 
-{{ ydb-short-name }} обеспечивает высокую доступность и сохранность данных благодаря синхронной репликации в трех зонах доступности. Также {{ ydb-short-name }} следит за равномерным распределением нагрузки на доступные аппаратные ресуры. Это значит, что не нужно заказывать ресурсы, Yandex Database автоматически выделяет и освобождает ресурсы, исходя из пользовательской нагрузки.
+{{ ydb-short-name }} обеспечивает высокую доступность и сохранность данных благодаря синхронной репликации в трех зонах доступности. Также {{ ydb-short-name }} следит за равномерным распределением нагрузки на доступные аппаратные ресуры. Это значит, что не нужно заказывать ресурсы, {{ ydb-short-name }} автоматически выделяет и освобождает ресурсы, исходя из пользовательской нагрузки.
 
-#### Какая модель консистентности используется в YDB? {#ydb-consistency}
+#### Какая модель консистентности используется в {{ ydb-short-name }}? {#ydb-consistency}
 
 Для чтения данных {{ ydb-short-name }} использует модель строгой консистентности (непротиворечивости) данных.
 
diff --git a/ydb/docs/ru/core/faq/_includes/index.md b/ydb/docs/ru/core/faq/_includes/index.md
index f8d8961bc1..eeb39f7916 100644
--- a/ydb/docs/ru/core/faq/_includes/index.md
+++ b/ydb/docs/ru/core/faq/_includes/index.md
@@ -1,4 +1,4 @@
-# Вопросы и ответы про {{ ydb-name }}
+# Вопросы и ответы про {{ ydb-short-name }}
 
 * [Общие](../common.md)
 {% if oss %}
diff --git a/ydb/docs/ru/core/getting_started/_includes/cli.md b/ydb/docs/ru/core/getting_started/_includes/cli.md
index f1560e0fd6..766c86c13a 100644
--- a/ydb/docs/ru/core/getting_started/_includes/cli.md
+++ b/ydb/docs/ru/core/getting_started/_includes/cli.md
@@ -1,4 +1,4 @@
-# YDB CLI - Начало работы
+# {{ ydb-short-name }} CLI - Начало работы
 
 ## Предварительные требования {#prerequisites}
 
@@ -11,7 +11,7 @@
 
 ## Установка CLI {#install}
 
-Установите YDB CLI как описано в статье [Установка YDB CLI](../../reference/ydb-cli/install.md).
+Установите {{ ydb-short-name }} CLI как описано в статье [Установка {{ ydb-short-name }} CLI](../../reference/ydb-cli/install.md).
 
 Проверьте успешность установки YDB CLI запуском с параметром `--help`:
 
@@ -34,7 +34,7 @@ ydb
 ...
 ```
 
-Все возможности работы со встроенной справкой YDB CLI описаны в статье [Встроенная справка](../../reference/ydb-cli/commands/service.md#help) справочника по YDB CLI.
+Все возможности работы со встроенной справкой {{ ydb-short-name }} CLI описаны в статье [Встроенная справка](../../reference/ydb-cli/commands/service.md#help) справочника по {{ ydb-short-name }} CLI.
 
 ## Проверьте успешность соединения {#ping} {#scheme-ls}
 
@@ -67,7 +67,7 @@ ydb
 
 ## Исполнение YQL скрипта {#yql}
 
-Команда YDB CLI `scripting yql` позволяет выполнить любую команду (как DDL так и DML) на [языке YQL](../../yql/reference/index.md) - диалекте SQL, поддерживаемом YDB:
+Команда {{ ydb-short-name }} CLI `scripting yql` позволяет выполнить любую команду (как DDL так и DML) на [языке YQL](../../yql/reference/index.md) - диалекте SQL, поддерживаемом {{ ydb-short-name }}:
 
 ``` bash
 {{ ydb-cli }} --profile <profile_name> yql -s <yql_request>
@@ -100,4 +100,4 @@ YDB CLI поддерживает отдельные команды с полны
 
 ## Продолжение знакомства с YDB {#next}
 
-Перейдите к статье [YQL - Начало работы](../yql.md) для продолжения знакомства с YDB.
-\ No newline at end of file
+Перейдите к статье [YQL - Начало работы](../yql.md) для продолжения знакомства с YDB.
diff --git a/ydb/docs/ru/core/getting_started/_includes/index/create_db.md b/ydb/docs/ru/core/getting_started/_includes/index/create_db.md
index 924df73ee3..12cffcad0e 100644
--- a/ydb/docs/ru/core/getting_started/_includes/index/create_db.md
+++ b/ydb/docs/ru/core/getting_started/_includes/index/create_db.md
@@ -1 +1 @@
-- [Создание базы данных](../../create_db.md) - запустите самостоятельно OpenSource БД YDB
-\ No newline at end of file
+- [Создание базы данных](../../create_db.md) - запустите самостоятельно OpenSource БД {{ ydb-short-name }}
+\ No newline at end of file
diff --git a/ydb/docs/ru/core/getting_started/_includes/index/intro.md b/ydb/docs/ru/core/getting_started/_includes/index/intro.md
index ceebfc9dcd..ba6aafc46a 100644
--- a/ydb/docs/ru/core/getting_started/_includes/index/intro.md
+++ b/ydb/docs/ru/core/getting_started/_includes/index/intro.md
@@ -1,4 +1,4 @@
-# Начало работы с {{ ydb-name }}
+# Начало работы с {{ ydb-short-name }}
 
 Статьи в этом разделе подскажут вам быстрый путь для того, чтобы начать работать с {{ ydb-short-name }}.
 
diff --git a/ydb/docs/ru/core/getting_started/_includes/index/sdk.md b/ydb/docs/ru/core/getting_started/_includes/index/sdk.md
index 401ecd85e2..c1c4501c49 100644
--- a/ydb/docs/ru/core/getting_started/_includes/index/sdk.md
+++ b/ydb/docs/ru/core/getting_started/_includes/index/sdk.md
@@ -1 +1 @@
-* [YDB SDK](../../sdk.md) — познакомьтесь с {{ ydb-short-name }} SDK для разных языков программирования, выполните простые запросы к БД из приложений-примеров.
+* [{{ ydb-short-name }} SDK](../../sdk.md) — познакомьтесь с {{ ydb-short-name }} SDK для разных языков программирования, выполните простые запросы к БД из приложений-примеров.
diff --git a/ydb/docs/ru/core/getting_started/_includes/sdk.md b/ydb/docs/ru/core/getting_started/_includes/sdk.md
index 86148bd03c..e11b48048f 100644
--- a/ydb/docs/ru/core/getting_started/_includes/sdk.md
+++ b/ydb/docs/ru/core/getting_started/_includes/sdk.md
@@ -1,16 +1,16 @@
-# YDB SDK - Начало работы
+# {{ ydb-short-name }} SDK - Начало работы
 
-YDB SDK - набор программных компонентов, поддерживающих работу с базами данных YDB для приложений на разных языках программирования.
+{{ ydb-short-name }} SDK - набор программных компонентов, поддерживающих работу с базами данных {{ ydb-short-name }} для приложений на разных языках программирования.
 
-Выполните следующие шаги для запуска простейшего приложения, использующего YDB:
+Выполните следующие шаги для запуска простейшего приложения, использующего {{ ydb-short-name }}:
 
-1. [Установите YDB SDK](../../reference/ydb-sdk/install.md) для нужного языка программирования
+1. [Установите {{ ydb-short-name }} SDK](../../reference/ydb-sdk/install.md) для нужного языка программирования
 
 2. Скачайте и запустите готовое тестовое приложение, использующее SDK для установленного языка программирования, и изучите его код:
 
    - [Python](../../reference/ydb-sdk/example/python/index.md)
    - [Go](../../reference/ydb-sdk/example/go/index.md)
 
-Полная информация о YDB SDK находится в разделе [Работа с YDB SDK](../../reference/ydb-sdk/index.md).
+Полная информация о {{ ydb-short-name }} SDK находится в разделе [Работа с {{ ydb-short-name }} SDK](../../reference/ydb-sdk/index.md).
 
 
diff --git a/ydb/docs/ru/core/getting_started/_includes/useful_links.md b/ydb/docs/ru/core/getting_started/_includes/useful_links.md
index d49e276768..0f4a83c4bc 100644
--- a/ydb/docs/ru/core/getting_started/_includes/useful_links.md
+++ b/ydb/docs/ru/core/getting_started/_includes/useful_links.md
@@ -1,6 +1,6 @@
 # Полезные ссылки
 
 {% if oss %}
-* [Сайт YDB OpenSource](https://ydb.tech){% endif %}
+* [Сайт {{ ydb-short-name }} OpenSource](https://ydb.tech){% endif %}
 * [Консоль управления в Yandex.Cloud](https://console.cloud.yandex.ru)
 * [GitHub account ydb-platform](https://github.com/ydb-platform)
diff --git a/ydb/docs/ru/core/getting_started/_includes/ydb_docker/01_intro.md b/ydb/docs/ru/core/getting_started/_includes/ydb_docker/01_intro.md
index e4abfe80f1..91bc488365 100644
--- a/ydb/docs/ru/core/getting_started/_includes/ydb_docker/01_intro.md
+++ b/ydb/docs/ru/core/getting_started/_includes/ydb_docker/01_intro.md
@@ -1,4 +1,4 @@
-# Использование Docker-контейнера YDB
+# Использование Docker-контейнера {{ ydb-short-name }}
 
 Для отладки или тестирования вы можете запустить [Docker](https://docs.docker.com/get-docker/)-контейнер YDB.
 
diff --git a/ydb/docs/ru/core/getting_started/_includes/yql.md b/ydb/docs/ru/core/getting_started/_includes/yql.md
index 8195a1b7c0..e1ac925652 100644
--- a/ydb/docs/ru/core/getting_started/_includes/yql.md
+++ b/ydb/docs/ru/core/getting_started/_includes/yql.md
@@ -2,26 +2,26 @@
 
 ## Введение {#intro}
 
-YQL - язык запросов к базе данных YDB, диалект SQL. В частности, он обладает синтаксическими особенностями, рассчитанными на его применение при исполнении запросов на кластерах.
+YQL - язык запросов к базе данных {{ ydb-short-name }}, диалект SQL. В частности, он обладает синтаксическими особенностями, рассчитанными на его применение при исполнении запросов на кластерах.
 
-YDB предоставляет следующие способы отправки запроса к базе данных на языке YQL:
+{{ ydb-short-name }} предоставляет следующие способы отправки запроса к базе данных на языке YQL:
 
 {% include [yql/ui_prompt.md](yql/ui_prompt.md) %}
 
-- [YDB CLI](#cli)
-- [YDB SDK](../sdk.md)
+- [{{ ydb-short-name }} CLI](#cli)
+- [{{ ydb-short-name }} SDK](../sdk.md)
 
 Полная информация по синтаксису YQL находится в [справочнике по YQL](../../yql/reference/index.md).
 
 Приведенные ниже примеры формируют сценарий знакомства с YQL, и предполагают последовательное выполнение: запросы в разделе ["Работа с данными"](#dml) обращаются к данным в таблицах, созданным в разделе ["Работа со схемой данных"](#ddl). Выполняйте шаги последовательно, чтобы скопированные через буфер обмена примеры успешно исполнялись.
 
-Базовый интерфейс YDB YQL принимает на вход не одну команду, а скрипт, который может состоять из множества команд.
+Базовый интерфейс {{ ydb-short-name }} YQL принимает на вход не одну команду, а скрипт, который может состоять из множества команд.
 
 {% include [yql/ui_execute.md](yql/ui_execute.md) %}
 
-### Исполнение YQL в YDB CLI {#cli}
+### Исполнение YQL в {{ ydb-short-name }} CLI {#cli}
 
-Для исполнения скриптов через YDB CLI нужно предварительно:
+Для исполнения скриптов через {{ ydb-short-name }} CLI нужно предварительно:
 - Выполнить [установку CLI](../cli.md#install)
 - Определить и проверить [параметры соединения с БД](../cli#scheme-ls)
 - [Создать профиль `db1`](../cli.md#profile), настроенный на соединение с вашей БД.
@@ -38,7 +38,7 @@ YDB предоставляет следующие способы отправк�
 
 Таблица с заданными колонками создается [командой YQL `CREATE TABLE`](../../yql/reference/syntax/create_table.md). В таблице обязательно должен быть определен первичный ключ. Типы данных для колонок приведены в статье [Типы данных YQL](../../yql/reference/types/index.md).
 
-YDB в настоящее время не поддерживает ограничение `NOT NULL`, все колонки будут допускать отсутствие значений, включая колонки первичного ключа. YDB также не поддерживает ограничения `FOREIGN KEY`.
+{{ ydb-short-name }} в настоящее время не поддерживает ограничение `NOT NULL`, все колонки будут допускать отсутствие значений, включая колонки первичного ключа. {{ ydb-short-name }} также не поддерживает ограничения `FOREIGN KEY`.
 
 Создайте таблицы каталога сериалов: `series` (Сериалы), `seasons` (Сезоны), и `episodes` (Эпизоды), выполнив следующий скрипт:
 
@@ -76,7 +76,7 @@ CREATE TABLE episodes (
 - [`ALTER TABLE`](../../yql/reference/syntax/alter_table) - изменение состава колонок таблицы и её параметров
 - [`DROP TABLE`](../../yql/reference/syntax/drop_table) - удаление таблицы
 
-Для исполнения скрипта через YDB CLI выполните инструкции, приведенные в пункте ["Исполнение в YDB CLI"](#cli) данной статьи.
+Для исполнения скрипта через {{ ydb-short-name }} CLI выполните инструкции, приведенные в пункте ["Исполнение в {{ ydb-short-name }} CLI"](#cli) данной статьи.
 
 ### Получение перечня существующих таблиц в БД {#scheme-ls}
 
@@ -84,7 +84,7 @@ CREATE TABLE episodes (
 
 {% include [yql/ui_scheme_ls.md](yql/ui_scheme_ls.md) %}
 
-Для получения перечня существующих таблиц в БД через YDB CLI убедитесь, что выполнены предварительные требования пункта ["Исполнение в YDB CLI"](#cli) данной статьи, и выполните [команду `scheme ls`](../cli.md#ping):
+Для получения перечня существующих таблиц в БД через {{ ydb-short-name }} CLI убедитесь, что выполнены предварительные требования пункта ["Исполнение в {{ ydb-short-name }} CLI"](#cli) данной статьи, и выполните [команду `scheme ls`](../cli.md#ping):
 
 ``` bash
 {{ ydb-cli }} --profile db1 scheme ls
@@ -96,9 +96,9 @@ CREATE TABLE episodes (
 
 ### UPSERT : Запись данных {#upsert}
 
-Самым эффективным способом записи данных в YDB является нестандартная для SQL [команда `UPSERT`](../../yql/reference/syntax/upsert_into.md). Она выполняет запись новых данных по первичным ключам независимо от того, существовали ли данные по этим ключам ранее в таблице. В результате, в отличие от привычных `INSERT` и `UPDATE`, её исполнение не требует на сервере предварительного чтения данных для проверки уникальности ключа. Всегда при работе с YDB рассматривайте `UPSERT` как основной способ записи данных, используя другие команды только при необходимости.
+Самым эффективным способом записи данных в {{ ydb-short-name }} является нестандартная для SQL [команда `UPSERT`](../../yql/reference/syntax/upsert_into.md). Она выполняет запись новых данных по первичным ключам независимо от того, существовали ли данные по этим ключам ранее в таблице. В результате, в отличие от привычных `INSERT` и `UPDATE`, её исполнение не требует на сервере предварительного чтения данных для проверки уникальности ключа. Всегда при работе с {{ ydb-short-name }} рассматривайте `UPSERT` как основной способ записи данных, используя другие команды только при необходимости.
 
-Все команды записи данных в YDB поддерживают работу как с выборками, так и со множеством записей, передаваемых непосредственно с запросе.
+Все команды записи данных в {{ ydb-short-name }} поддерживают работу как с выборками, так и со множеством записей, передаваемых непосредственно с запросе.
 
 Добавим данные в созданные ранее таблицы:
 
@@ -134,7 +134,7 @@ VALUES
     (2, 1, 2, "The Cap Table", CAST(Date("2014-04-13") AS Uint64))
 ;
 ```
-Для исполнения скрипта через YDB CLI выполните инструкции, приведенные в пункте ["Исполнение в YDB CLI"](#cli) данной статьи.
+Для исполнения скрипта через {{ ydb-short-name }} CLI выполните инструкции, приведенные в пункте ["Исполнение в {{ ydb-short-name }} CLI"](#cli) данной статьи.
 
 ### SELECT : Выборка данных {#select}
 
@@ -154,17 +154,17 @@ SELECT * FROM episodes;
 
 Если в скрипте YQL будет несколько команд `SELECT`, то в результате его исполнения будет возвращено несколько выборок, к каждой из которых можно обратиться отдельно. Выполните приведенные выше команды `SELECT`, объединенные в одном скрипте.
 
-Для исполнения скрипта через YDB CLI выполните инструкции, приведенные в пункте ["Исполнение в YDB CLI"](#cli) данной статьи.
+Для исполнения скрипта через {{ ydb-short-name }} CLI выполните инструкции, приведенные в пункте ["Исполнение в {{ ydb-short-name }} CLI"](#cli) данной статьи.
 
 ### Параметризованные запросы {#param}
 
-Для транзакционных приложений, работающих с базой данных, характерно исполнение множества однотипных запросов, отличающихся только параметрами. Как и большинство баз данных, YDB будет работать эффективнее, если вы определите изменяемые параметры и их типы, а далее будете инициировать исполнение запроса, передавая значения параметров отдельно от его текста.
+Для транзакционных приложений, работающих с базой данных, характерно исполнение множества однотипных запросов, отличающихся только параметрами. Как и большинство баз данных, {{ ydb-short-name }} будет работать эффективнее, если вы определите изменяемые параметры и их типы, а далее будете инициировать исполнение запроса, передавая значения параметров отдельно от его текста.
 
 Для определения параметров в тексте запроса YQL применяется [команда DECLARE](../../yql/reference/syntax/declare.md).
 
-Описание методов исполнения параметризованных запросов YDB SDK доступно в разделе [Тестовый пример](../../reference/ydb-sdk/example/index.md), в секции "Параметризованные запросы" для нужного языка программирования.
+Описание методов исполнения параметризованных запросов {{ ydb-short-name }} SDK доступно в разделе [Тестовый пример](../../reference/ydb-sdk/example/index.md), в секции "Параметризованные запросы" для нужного языка программирования.
 
-При отладке параметризованного запроса в YDB SDK вы можете проверить его работоспособность вызовом YDB CLI, скопировав полный текст запроса без каких-либо корректировок, и задав значения параметров.
+При отладке параметризованного запроса в {{ ydb-short-name }} SDK вы можете проверить его работоспособность вызовом {{ ydb-short-name }} CLI, скопировав полный текст запроса без каких-либо корректировок, и задав значения параметров.
 
 Сохраните скрипт выполнения параметрированного запроса в текстовом файле `script.yql`:
 
@@ -178,13 +178,13 @@ INNER JOIN series AS sr ON sa.series_id = sr.series_id
 WHERE sa.series_id = $seriesId AND sa.season_id = $seasonId;
 ```
 
-Для выполнения параметризованной выборки убедитесь, что выполнены предварительные требования пункта ["Исполнение в YDB CLI"](#cli) данной статьи, и выполните следующую команду:
+Для выполнения параметризованной выборки убедитесь, что выполнены предварительные требования пункта ["Исполнение в {{ ydb-short-name }} CLI"](#cli) данной статьи, и выполните следующую команду:
 
 ``` bash
 $ {{ ydb-cli }} --profile db1 scripting yql -f script.yql -p '$seriesId=1' -p '$seasonId=1'
 ```
 
-Полное описание возможностей передачи параметров находится в [справочнике по YDB CLI](../../reference/ydb-cli/index.md).
+Полное описание возможностей передачи параметров находится в [справочнике по {{ ydb-short-name }} CLI](../../reference/ydb-cli/index.md).
 
 ## Туториал YQL {#tutorial}
 
diff --git a/ydb/docs/ru/core/getting_started/ydb_local.md b/ydb/docs/ru/core/getting_started/ydb_local.md
index 8b08bc86f0..9974fd9dd6 100644
--- a/ydb/docs/ru/core/getting_started/ydb_local.md
+++ b/ydb/docs/ru/core/getting_started/ydb_local.md
@@ -1,6 +1,6 @@
-# Локальный запуск кластера {{ ydb-full-name }}
+# Локальный запуск кластера {{ ydb-short-name }}
 
-В данном разделе описывается процесс разворачивания локального кластера {{ ydb-full-name }} c использованием конфигурации в YAML формате.
+В данном разделе описывается процесс разворачивания локального кластера {{ ydb-short-name }} c использованием конфигурации в YAML формате.
 
 {% note warning %}
 
diff --git a/ydb/docs/ru/core/how_to_edit_docs/_includes/build/local_oss.md b/ydb/docs/ru/core/how_to_edit_docs/_includes/build/local_oss.md
index 94a9ecb9dc..2f498e4a96 100644
--- a/ydb/docs/ru/core/how_to_edit_docs/_includes/build/local_oss.md
+++ b/ydb/docs/ru/core/how_to_edit_docs/_includes/build/local_oss.md
@@ -4,7 +4,7 @@
 
 Порядок установки YFM-Docs описан на [вводной странице документации по этой утилите](https://ydocs.tech/ru/tools/docs/).
 
-Для сборки OpenSource документации YDB нужно выполнить команду:
+Для сборки OpenSource документации {{ ydb-short-name }} нужно выполнить команду:
 
 ``` bash
 $ yfm -i <source_dir> -o <output_dir> --allowHTML
diff --git a/ydb/docs/ru/core/how_to_edit_docs/_includes/content.md b/ydb/docs/ru/core/how_to_edit_docs/_includes/content.md
index 37e0b6bb16..196d4254a1 100644
--- a/ydb/docs/ru/core/how_to_edit_docs/_includes/content.md
+++ b/ydb/docs/ru/core/how_to_edit_docs/_includes/content.md
@@ -2,7 +2,7 @@
 
 ## Введение {#intro}
 
-Исходный код документации создается в формате [Markdown](https://ru.wikipedia.org/wiki/Markdown), с расширениями [YFM (Yandex Flavoured Markdown)](https://ydocs.tech/ru/). Эффективным способом быстро изучить эти форматы является знакомство с исходным кодом имеющейся документации YDB.
+Исходный код документации создается в формате [Markdown](https://ru.wikipedia.org/wiki/Markdown), с расширениями [YFM (Yandex Flavoured Markdown)](https://ydocs.tech/ru/). Эффективным способом быстро изучить эти форматы является знакомство с исходным кодом имеющейся документации {{ ydb-short-name }}.
 
 Кроме описанных здесь формальных правил, всегда действует неявное дополнение: если на какую-то тему правило формально не описано, необходимо посмотреть как уже сделано ранее в других местах документации, и сделать по аналогии.
 
@@ -10,7 +10,7 @@
 
 ## Ядро и кастомизация документации
 
-OpenSource документация по YDB поддерживает создание на её базе кастомизированных документаций для enterprise-окружений где эксплуатируется YDB, или для облачных провайдеров, предоставляющих сервис YDB в своих экосистемах.
+OpenSource документация по {{ ydb-short-name }} поддерживает создание на её базе кастомизированных документаций для enterprise-окружений где эксплуатируется {{ ydb-short-name }}, или для облачных провайдеров, предоставляющих сервис {{ ydb-short-name }} в своих экосистемах.
 
 При добавлении контента вам придется в первую очередь выбрать куда его добавлять: в OpenSource ядро, или в какую-либо кастомизацию. Общая рекомендация - добавлять контент в OpenSource блок таким образом, чтобы он мог читаться в разных контекстах без необходимости его специфичной адаптации. Только когда это сделать не удается, или размещение в OpenSource ядре какого-то контента явно запрещено (например, ссылок на ресурсы интранет в enterprise-контексте), можно переходить к добавлению контента в исходный код кастомизации документации.
 
@@ -267,7 +267,7 @@ OpenSource документация по YDB поддерживает созда
 Существуют ситуации, когда URL ресурса имеет самостоятельную ценность, и должен быть отображен в документации, например, в случае публикации ссылок на репозиторий в github. В таких случаях его необходимо дублировать как внутри квадратных скобок, так и внутри обычных, так как YFM, в отличие от стандартного Markdown, не распознает автоматом URL в тексте:
 
 ``` md
-Github репозиторий YDB: [https://github.com/ydb-platform/ydb/tree/master/docs](https://github.com/ydb-platform/ydb/tree/master/docs)
+Github репозиторий {{ ydb-short-name }}: [https://github.com/ydb-platform/ydb/tree/master/docs](https://github.com/ydb-platform/ydb/tree/master/docs)
 ```
 
 ## Картинки {#pictures}
diff --git a/ydb/docs/ru/core/how_to_edit_docs/_includes/contribute.md b/ydb/docs/ru/core/how_to_edit_docs/_includes/contribute.md
index 400edabf47..fd46b79d60 100644
--- a/ydb/docs/ru/core/how_to_edit_docs/_includes/contribute.md
+++ b/ydb/docs/ru/core/how_to_edit_docs/_includes/contribute.md
@@ -1,8 +1,8 @@
 # Как участвовать в разработке документации
 
-Исходный код документации YDB открыт и опубликован на [https://github.com/ydb-platform/ydb/tree/master/docs](https://github.com/ydb-platform/ydb/tree/master/docs).
+Исходный код документации {{ ydb-short-name }} открыт и опубликован на [https://github.com/ydb-platform/ydb/tree/master/docs](https://github.com/ydb-platform/ydb/tree/master/docs).
 
-Команда YDB принимает запросы на изменения и дополнения в документации YDB, который может предложить каждый желающий через механизм [Pull Requests на github.com](https://docs.github.com/en/desktop/contributing-and-collaborating-using-github-desktop/working-with-your-remote-repository-on-github-or-github-enterprise/creating-an-issue-or-pull-request).
+Команда {{ ydb-short-name }} принимает запросы на изменения и дополнения в документации {{ ydb-short-name }}, который может предложить каждый желающий через механизм [Pull Requests на github.com](https://docs.github.com/en/desktop/contributing-and-collaborating-using-github-desktop/working-with-your-remote-repository-on-github-or-github-enterprise/creating-an-issue-or-pull-request).
 
 Прежде чем создавать такой запрос, необходимо ознакомиться с требованиями по разработке документации, описанными в статьях данного раздела, и [проверить сборку локально](../build.md).
 
diff --git a/ydb/docs/ru/core/how_to_edit_docs/_includes/customize.md b/ydb/docs/ru/core/how_to_edit_docs/_includes/customize.md
index a90cd98fa1..e2b5d97bb4 100644
--- a/ydb/docs/ru/core/how_to_edit_docs/_includes/customize.md
+++ b/ydb/docs/ru/core/how_to_edit_docs/_includes/customize.md
@@ -1,4 +1,4 @@
-# Создание кастомизированной документации по YDB
+# Создание кастомизированной документации по {{ ydb-short-name }}
 
 Содержимое подкаталога `core` подключается в разные окружения сборки документации как библиотека, для создания кастомизированной документации. 
 
@@ -15,7 +15,11 @@
 
 ### TOC (Table of Contents) - содержание
 
+<<<<<<< ydb/docs/ru/core/how_to_edit_docs/_includes/customize.md
 TOC в документации YDB собирается из множества файлов, размещенных в директориях со статьями, которые иерархически включаются друг в друга директивой include. В результате каждый из этих файлов может быть переопределен по отдельности в адаптированной документации.
+=======
+TOC в документации {{ ydb-short-name }} собирается из множества файлов, размещенных в директориях со статьями, которые иерархически включаются друг в друга директивой include. В результате, каждый из этих файлов может быть переопределен по-отдельности в адаптированной документации.
+>>>>>>> ydb/docs/ru/core/how_to_edit_docs/_includes/customize.md
 
 Как и для статей, для файлов TOC применяется подход с прокси, со следующей реализацией:
 
diff --git a/ydb/docs/ru/core/how_to_edit_docs/_includes/index/intro.md b/ydb/docs/ru/core/how_to_edit_docs/_includes/index/intro.md
index 7338aa067f..2adec431ab 100644
--- a/ydb/docs/ru/core/how_to_edit_docs/_includes/index/intro.md
+++ b/ydb/docs/ru/core/how_to_edit_docs/_includes/index/intro.md
@@ -2,4 +2,4 @@
 
 ## Введение
 
-В репозитории [https://github.com/ydb-platform/ydb/tree/master/docs](https://github.com/ydb-platform/ydb/tree/master/docs) размещен публично доступный исходный код документации по YDB на русском и английском языках. На его основании собирается и публикуется документация по OpenSource версии YDB на сайте [http://ydb.tech](http://ydb.tech), а также он используется для создания кастомизированной документации по YDB для enterprise-окружений и облачных сервисов.
+В репозитории [https://github.com/ydb-platform/ydb/tree/master/docs](https://github.com/ydb-platform/ydb/tree/master/docs) размещен публично доступный исходный код документации по {{ ydb-short-name }} на русском и английском языках. На его основании собирается и публикуется документация по OpenSource версии {{ ydb-short-name }} на сайте [http://ydb.tech](http://ydb.tech), а также он используется для создания кастомизированной документации по {{ ydb-short-name }} для enterprise-окружений и облачных сервисов.
diff --git a/ydb/docs/ru/core/how_to_edit_docs/_includes/subjects.md b/ydb/docs/ru/core/how_to_edit_docs/_includes/subjects.md
index aa65f08683..3adf0be67f 100644
--- a/ydb/docs/ru/core/how_to_edit_docs/_includes/subjects.md
+++ b/ydb/docs/ru/core/how_to_edit_docs/_includes/subjects.md
@@ -1,14 +1,14 @@
-# Структура тематических каталогов документации YDB
+# Структура тематических каталогов документации {{ ydb-short-name }}
 
 ## Введение {#intro}
 
 Статьи документации размещаются в иерархической структуре тематических директорий. Тематическая директория объединяет набор статей на определенную общую тематику.
 
 Описание тематики включает в себя:
-1. Целевую аудиторию, то есть для кого написана статья. Аудитория определяется ролью потенциального читателя при работе с YDB, со следующими тремя базовыми аудиториями: 
-   - Разработчик приложений на YDB
-   - Администратор YDB
-   - Разработчик/контрибьютор YDB
+1. Целевую аудиторию, то есть для кого написана статья. Аудитория определяется ролью потенциального читателя при работе с {{ ydb-short-name }}, со следующими тремя базовыми аудиториями: 
+   - Разработчик приложений на {{ ydb-short-name }}
+   - Администратор {{ ydb-short-name }}
+   - Разработчик/контрибьютор {{ ydb-short-name }}
 2. Назначение -- задачу или проблему читателя, решение которой описывается в контенте.
 
 В основном, структура директорий напрямую отражается на структуре оглавления документации. Типовыми исключениями являются:
@@ -22,12 +22,12 @@
 | Имя | Аудитория | Назначение |
 | --- | ----------| ---------- |
 | getting_started | Все | Предоставить быстрые решения типовых задач, которые возникают при начале работы с новой БД: что это, как поставить, как соединиться, как выполнить простейшие операции с данными, куда дальше по каким вопросам ходить в документации |
-| concepts | Разработчик приложений | Ознакомить с основными структурными компонентами YDB, с которыми придется иметь дело при разработке приложений под YDB. Дать понимание роли каждого такого компонента при решении задач разработки приложений. Предоставить расширенную информацию по вариантам конфигурации компонентов, доступных разработчик приложений. |
-| reference, yql | Разработчик приложений | Справочник для ежедневного использования по инструментам доступа к функциям YDB: CLI, YQL, SDK |
+| concepts | Разработчик приложений | Ознакомить с основными структурными компонентами {{ ydb-short-name }}, с которыми придется иметь дело при разработке приложений под {{ ydb-short-name }}. Дать понимание роли каждого такого компонента при решении задач разработки приложений. Предоставить расширенную информацию по вариантам конфигурации компонентов, доступных разработчик приложений. |
+| reference, yql | Разработчик приложений | Справочник для ежедневного использования по инструментам доступа к функциям {{ ydb-short-name }}: CLI, YQL, SDK |
 | best_practices | Разработчик приложений | Типовые подходы к решению основных задач, возникающих при разработке приложений |
-| maintenance | Разработчик приложений | Как обслуживать свои базы данных YDB на администрируемом кем-то большом кластере, или при самостоятельном развертывании небольших БД для разработки: резервные копии, мониторинг, логи |
+| maintenance | Разработчик приложений | Как обслуживать свои базы данных {{ ydb-short-name }} на администрируемом кем-то большом кластере, или при самостоятельном развертывании небольших БД для разработки: резервные копии, мониторинг, логи |
 | troubleshooting | ? | Инструменты локализации причин проблем |
-| how_to_edit_docs | Разработчики YDB | Как дорабатывать документацию по YDB |
+| how_to_edit_docs | Разработчики {{ ydb-short-name }} | Как дорабатывать документацию по {{ ydb-short-name }} |
 | faq | Все | Вопросы и ответы |
 
 
diff --git a/ydb/docs/ru/core/index.yaml b/ydb/docs/ru/core/index.yaml
index 409a8704ae..4763f9d755 100644
--- a/ydb/docs/ru/core/index.yaml
+++ b/ydb/docs/ru/core/index.yaml
@@ -1,14 +1,14 @@
-title: Yandex Database
+title: YDB
 description:
   - >-
-    <i>Yandex Database</i> (YDB) — это распределённая отказоустойчивая Distributed SQL СУБД.
+    <i>YDB</i> — это распределённая отказоустойчивая Distributed SQL СУБД.
     YDB обеспечивает высокую доступность, горизонтальную масштабируемость, а также строгую консистентность и поддержку ACID-транзакций.
     Для запросов используется диалект SQL (<a
     href="yql/reference/overview">YQL</a>).
 nav:
-  title: Yandex Database
+  title: YDB
 meta:
-  title: Yandex Database
+  title: YDB
 links:
   - title: Начало работы
     description: Создание базы данных, подключение, настройка доступа, простейшие операции
diff --git a/ydb/docs/ru/core/maintenance/_includes/backup_and_recovery/01_intro.md b/ydb/docs/ru/core/maintenance/_includes/backup_and_recovery/01_intro.md
index 73948e3b9c..a87bcd2d2f 100644
--- a/ydb/docs/ru/core/maintenance/_includes/backup_and_recovery/01_intro.md
+++ b/ydb/docs/ru/core/maintenance/_includes/backup_and_recovery/01_intro.md
@@ -1,11 +1,11 @@
 ---
-title: "Резервное копирование Yandex Database (YDB)"
-description: "В разделе описаны поддерживаемые способы создания резервных копий баз данных Yandex Database (YDB) и восстановления из созданных ранее резервных копий. YDB позволяет использовать для создания резервных копий csv-файлы на файловой системе и AWS S3-совместимые хранилища."
+title: "Резервное копирование YDB"
+description: "В разделе описаны поддерживаемые способы создания резервных копий баз данных YDB и восстановления из созданных ранее резервных копий. YDB позволяет использовать для создания резервных копий csv-файлы на файловой системе и AWS S3-совместимые хранилища."
 ---
 
 # Резервное копирование
 
-В этом разделе описаны поддерживаемые способы создания резервных копий баз данных YDB и восстановления из созданных ранее резервных копий. {{ ydb-short-name }} позволяет использовать следующие места назначения для создания резервных копий:
+В этом разделе описаны поддерживаемые способы создания резервных копий баз данных {{ ydb-short-name }} и восстановления из созданных ранее резервных копий. {{ ydb-short-name }} позволяет использовать следующие места назначения для создания резервных копий:
 * csv-файлы на файловой системе;
 * AWS S3-совместимые хранилища.
 
diff --git a/ydb/docs/ru/core/maintenance/_includes/backup_and_recovery/02_prerequisites.md b/ydb/docs/ru/core/maintenance/_includes/backup_and_recovery/02_prerequisites.md
index beef2df419..4efcf3a7b8 100644
--- a/ydb/docs/ru/core/maintenance/_includes/backup_and_recovery/02_prerequisites.md
+++ b/ydb/docs/ru/core/maintenance/_includes/backup_and_recovery/02_prerequisites.md
@@ -1,6 +1,6 @@
 ## Предварительные требования
 
-1. Установите [консольный клиент YDB](../../../reference/ydb-cli/index.md).
+1. Установите [консольный клиент {{ ydb-short-name }}](../../../reference/ydb-cli/index.md).
 1. Узнайте параметры для соединения с базой данных -- **Эндпоинт** и **База данных**.
 1. Сохраните значения параметров **Эндпоинт** и **База данных** в переменных окружения `$YDB_ENDPOINT` и `$YDB_DB_PATH`.
 
diff --git a/ydb/docs/ru/core/maintenance/_includes/backup_and_recovery/03_limitations.md b/ydb/docs/ru/core/maintenance/_includes/backup_and_recovery/03_limitations.md
index f0aac263ff..cf990c6139 100644
--- a/ydb/docs/ru/core/maintenance/_includes/backup_and_recovery/03_limitations.md
+++ b/ydb/docs/ru/core/maintenance/_includes/backup_and_recovery/03_limitations.md
@@ -1,3 +1,3 @@
 ## Ограничения {#limitations}
 
-В текущей реализации в YDB допустимо создание резервной копии не более чем 1000 таблиц одновременно.
-\ No newline at end of file
+В текущей реализации в {{ ydb-short-name }} допустимо создание резервной копии не более чем 1000 таблиц одновременно.
+\ No newline at end of file
diff --git a/ydb/docs/ru/core/maintenance/_includes/backup_and_recovery/06_s3_1_header.md b/ydb/docs/ru/core/maintenance/_includes/backup_and_recovery/06_s3_1_header.md
index c3b07cfa2b..77c5dcf325 100644
--- a/ydb/docs/ru/core/maintenance/_includes/backup_and_recovery/06_s3_1_header.md
+++ b/ydb/docs/ru/core/maintenance/_includes/backup_and_recovery/06_s3_1_header.md
@@ -1,4 +1,4 @@
 ## Резервное копирование в S3-совместимые хранилища {#s3_backup}
 
-YDB позволяет сохранять резервные копии баз данных в хранилища, поддерживающие [Amazon Simple Storage Service (AWS S3) API](https://docs.aws.amazon.com/AmazonS3/latest/dev/Introduction.html).
+{{ ydb-short-name }} позволяет сохранять резервные копии баз данных в хранилища, поддерживающие [Amazon Simple Storage Service (AWS S3) API](https://docs.aws.amazon.com/AmazonS3/latest/dev/Introduction.html).
 
diff --git a/ydb/docs/ru/core/maintenance/_includes/backup_and_recovery/06_s3_3_access_keys.md b/ydb/docs/ru/core/maintenance/_includes/backup_and_recovery/06_s3_3_access_keys.md
index 006dba7cd1..53431af5ea 100644
--- a/ydb/docs/ru/core/maintenance/_includes/backup_and_recovery/06_s3_3_access_keys.md
+++ b/ydb/docs/ru/core/maintenance/_includes/backup_and_recovery/06_s3_3_access_keys.md
@@ -1,6 +1,6 @@
 ### Создание ключей доступа {#s3_create_access_keys}
 
-Для аутентификации и авторизации в S3-совместимых хранилищах используются ключи доступа. [Консольный клиент YDB](../../../reference/ydb-cli/index.md) предоставляет три варианта передачи ключей:
+Для аутентификации и авторизации в S3-совместимых хранилищах используются ключи доступа. [Консольный клиент {{ ydb-short-name }}](../../../reference/ydb-cli/index.md) предоставляет три варианта передачи ключей:
 
 * через опции командной строки `--access-key` и `--secret-key`;
 * через переменные окружения `AWS_ACCESS_KEY_ID` и `AWS_SECRET_ACCESS_KEY`;
diff --git a/ydb/docs/ru/core/maintenance/_includes/backup_and_recovery/06_s3_4_export.md b/ydb/docs/ru/core/maintenance/_includes/backup_and_recovery/06_s3_4_export.md
index 60f8ddfe1c..11e56f879f 100644
--- a/ydb/docs/ru/core/maintenance/_includes/backup_and_recovery/06_s3_4_export.md
+++ b/ydb/docs/ru/core/maintenance/_includes/backup_and_recovery/06_s3_4_export.md
@@ -2,7 +2,7 @@
 
 Команды в примерах ниже составлены из расчёта, что данные ключей доступа сохранены в файл `~/.aws/credentials`.
 
-Запуск операции операции экспорта данных из таблиц `$YDB_DB_PATH/backup/episodes`, `$YDB_DB_PATH/backup/seasons`, `$YDB_DB_PATH/backup/series` в YDB в базе `$YDB_DB_PATH` в файлы с префиксом `20200601/` в бакете `testdbbackups` в {{ objstorage-name }}.
+Запуск операции операции экспорта данных из таблиц `$YDB_DB_PATH/backup/episodes`, `$YDB_DB_PATH/backup/seasons`, `$YDB_DB_PATH/backup/series` в {{ ydb-short-name }} в базе `$YDB_DB_PATH` в файлы с префиксом `20200601/` в бакете `testdbbackups` в {{ objstorage-name }}.
 ```
 {{ ydb-cli }} -e $YDB_ENDPOINT -d $YDB_DB_PATH export s3 --s3-endpoint {{ s3-storage-host }}  --bucket testdbbackups\
 --item source=$YDB_DB_PATH/backup/episodes,destination=20200601/episodes\
@@ -50,7 +50,7 @@ aws --endpoint-url=https://{{ s3-storage-host }} s3 ls testdbbackups/20200601/
 
 {% note info "Работа с директориями" %}
 
-Чтобы сделать резервную копию всех таблиц в директории YDB, следует указать путь до директории в качестве источника.
+Чтобы сделать резервную копию всех таблиц в директории {{ ydb-short-name }}, следует указать путь до директории в качестве источника.
 
 ```
 {{ ydb-cli }} -e $YDB_ENDPOINT -d $YDB_DB_PATH export s3 \
diff --git a/ydb/docs/ru/core/maintenance/_includes/backup_and_recovery/06_s3_5_restore.md b/ydb/docs/ru/core/maintenance/_includes/backup_and_recovery/06_s3_5_restore.md
index 6e4c18ab24..bd8f54e996 100644
--- a/ydb/docs/ru/core/maintenance/_includes/backup_and_recovery/06_s3_5_restore.md
+++ b/ydb/docs/ru/core/maintenance/_includes/backup_and_recovery/06_s3_5_restore.md
@@ -1,5 +1,5 @@
 ### Восстановление из S3-совместимых хранилищ {#s3_restore}
 
-Предварительно нужно подключить бакет, содержащий файлы с резервной копией базы YDB в s3-совместимом хранилище, чтобы она была доступна через операции с файловой системой.
+Предварительно нужно подключить бакет, содержащий файлы с резервной копией базы {{ ydb-short-name }} в s3-совместимом хранилище, чтобы она была доступна через операции с файловой системой.
 
-После успешного подключения следует загрузить данные из копии в YDB по инструкции, описанной в разделе [Восстановление из резервной копии на файловой системе](#filesystem_restore).
-\ No newline at end of file
+После успешного подключения следует загрузить данные из копии в {{ ydb-short-name }} по инструкции, описанной в разделе [Восстановление из резервной копии на файловой системе](#filesystem_restore).
+\ No newline at end of file
diff --git a/ydb/docs/ru/core/maintenance/_includes/backup_and_recovery/06_s3_6_forget.md b/ydb/docs/ru/core/maintenance/_includes/backup_and_recovery/06_s3_6_forget.md
index e4330d5437..3418329810 100644
--- a/ydb/docs/ru/core/maintenance/_includes/backup_and_recovery/06_s3_6_forget.md
+++ b/ydb/docs/ru/core/maintenance/_includes/backup_and_recovery/06_s3_6_forget.md
@@ -1,6 +1,6 @@
 ### Завершение операции резервного копирования {#s3_forget}
 
-Для минимизации влияния процесса резервного копирования на показатели пользовательской нагрузки отправка данных осуществляется с копий таблиц. Перед отправкой данных из YDB процесс резервного копирования создаёт консистентные копии всех отправляемых таблиц в YDB. Так как это copy-on-write копии, то в момент их создания размер базы практически не меняется. После завершения отправки данных созданные копии остаются в базе.
+Для минимизации влияния процесса резервного копирования на показатели пользовательской нагрузки отправка данных осуществляется с копий таблиц. Перед отправкой данных из {{ ydb-short-name }} процесс резервного копирования создаёт консистентные копии всех отправляемых таблиц в {{ ydb-short-name }}. Так как это copy-on-write копии, то в момент их создания размер базы практически не меняется. После завершения отправки данных созданные копии остаются в базе.
 
 Чтобы удалить созданные копии таблиц из базы и завершённую операцию из списка операций, нужно выполнить команду
 
diff --git a/ydb/docs/ru/core/maintenance/embedded_monitoring/overview.md b/ydb/docs/ru/core/maintenance/embedded_monitoring/overview.md
index eebecac7ae..5923081b81 100644
--- a/ydb/docs/ru/core/maintenance/embedded_monitoring/overview.md
+++ b/ydb/docs/ru/core/maintenance/embedded_monitoring/overview.md
@@ -1,9 +1,9 @@
 # Обзор средств интроспекции
 
-YDB предоставляет инструменты для мониторинга и определения состояния системы:
+{{ ydb-short-name }} предоставляет инструменты для мониторинга и определения состояния системы:
 
-* [YDB Monitoring](ydb_monitoring.md) - Основной обозреватель кластера. Показывает состояние узлов, групп хранения.
+* [{{ ydb-short-name }} Monitoring](ydb_monitoring.md) - Основной обозреватель кластера. Показывает состояние узлов, групп хранения.
 * [Interconnect overview](interconnect_overview.md) - состояние соединений узлов кластера друг с другом.
-* [Логи](logs.md) - Каждый компонент YDB пишет сообщения в логи разного уровня. По ним можно детектировать критические проблемы или разобраться в причинах неполадок.
-* [Графики](charts.md) - YDB собирает множество метрик, по которым можно определить состояние системы, либо конкретного компонента.
+* [Логи](logs.md) - Каждый компонент {{ ydb-short-name }} пишет сообщения в логи разного уровня. По ним можно детектировать критические проблемы или разобраться в причинах неполадок.
+* [Графики](charts.md) - {{ ydb-short-name }} собирает множество метрик, по которым можно определить состояние системы, либо конкретного компонента.
 
diff --git a/ydb/docs/ru/core/maintenance/manual/balancing_load.md b/ydb/docs/ru/core/maintenance/manual/balancing_load.md
index 9fa7cdc321..2aee87da39 100644
--- a/ydb/docs/ru/core/maintenance/manual/balancing_load.md
+++ b/ydb/docs/ru/core/maintenance/manual/balancing_load.md
@@ -1,6 +1,6 @@
 # Балансировка нагрузки на диски
 
-В YDB нагрузку на диски можно распределить двумя способами:
+В {{ ydb-short-name }} нагрузку на диски можно распределить двумя способами:
 
 ## Распределить нагрузку равномерно по группам
 
diff --git a/ydb/docs/ru/core/maintenance/manual/index.md b/ydb/docs/ru/core/maintenance/manual/index.md
index f35e7853f9..90f2ced2b7 100644
--- a/ydb/docs/ru/core/maintenance/manual/index.md
+++ b/ydb/docs/ru/core/maintenance/manual/index.md
@@ -16,7 +16,7 @@
 
 ## Изменение конфигурации кластера
 
-Кластер YDB позволяет:
+Кластер {{ ydb-short-name }} позволяет:
 
 * проводить [расширение](cluster_expansion.md) устройств и узлов.
 * [Конфигурировать](change_actorsystem_configs.md) актор-систему на узлах.
diff --git a/ydb/docs/ru/core/reference/ydb-cli/_includes/commands.md b/ydb/docs/ru/core/reference/ydb-cli/_includes/commands.md
index ce9719d0fe..4b841d2b22 100644
--- a/ydb/docs/ru/core/reference/ydb-cli/_includes/commands.md
+++ b/ydb/docs/ru/core/reference/ydb-cli/_includes/commands.md
@@ -1,6 +1,6 @@
-# Команды YDB CLI
+# Команды {{ ydb-short-name }} CLI
 
-Общий синтаксис вызова команд YDB CLI:
+Общий синтаксис вызова команд {{ ydb-short-name }} CLI:
 
 ``` bash
 {{ ydb-cli }} [global options] <command> [<subcommand> ...] [command options]
@@ -8,8 +8,8 @@
 
 , где:
 
-- `{{ ydb-cli}}` - команда запуска YDB CLI из командной строки операционной системы
-- `[global options]` - [глобальные опции](../commands/global-options.md), одинаковые для всех команд YDB CLI
+- `{{ ydb-cli}}` - команда запуска {{ ydb-short-name }} CLI из командной строки операционной системы
+- `[global options]` - [глобальные опции](../commands/global-options.md), одинаковые для всех команд {{ ydb-short-name }} CLI
 - `<command>` - команда
 - `[<subcomand>  ...]` - подкоманды, указываемые в случае если выбранная команда содержит подкоманды
 - `[command options]` - опции команды, специфичные для каждой команды и подкоманд
@@ -18,7 +18,7 @@
 
 Вы можете ознакомиться с нужными командами выбрав тематический раздел в меню слева, или воспользовавшись алфавитным перечнем ниже.
 
-Любая команда может быть вызвана в командной строке с опцией `--help` для получения справки по ней. Перечень всех поддерживаемых YDB CLI команд может быть получен запуском YDB CLI с опцией `--help` [без указания команды](../commands/service.md).
+Любая команда может быть вызвана в командной строке с опцией `--help` для получения справки по ней. Перечень всех поддерживаемых {{ ydb-short-name }} CLI команд может быть получен запуском {{ ydb-short-name }} CLI с опцией `--help` [без указания команды](../commands/service.md).
 
 Команда / подкоманда | Краткое описание
 --- | ---
@@ -68,8 +68,8 @@ tools dump | Выгрузка директории или таблицы в фа
 [tools rename](../commands/tools/rename.md) | Переименование таблиц
 tools restore | Восстановление из файловой системы
 {% if ydb-cli == "ydb" %}
-[update](../commands/service.md) | Обновление YDB CLI
-[version](../commands/service.md) | Вывод информации о версии YDB CLI
+[update](../commands/service.md) | Обновление {{ ydb-short-name }} CLI
+[version](../commands/service.md) | Вывод информации о версии {{ ydb-short-name }} CLI
 {% endif %}
 [workload](../commands/workload/index.md) | Генерация нагрузки
 yql | Выполнение YQL-скрипта (с поддержкой стриминга)
diff --git a/ydb/docs/ru/core/reference/ydb-cli/_includes/connect.md b/ydb/docs/ru/core/reference/ydb-cli/_includes/connect.md
index b3214ef573..78c0ee433f 100644
--- a/ydb/docs/ru/core/reference/ydb-cli/_includes/connect.md
+++ b/ydb/docs/ru/core/reference/ydb-cli/_includes/connect.md
@@ -1,19 +1,19 @@
 # Соединение CLI с базой данных и аутентификация
 
-Большинство команд YDB CLI относится к операциям над базой данных YDB и требует соединения с ней для исполнения.
+Большинство команд {{ ydb-short-name }} CLI относится к операциям над базой данных {{ ydb-short-name }} и требует соединения с ней для исполнения.
 
-YDB CLI определяет с какой БД необходимо соединиться и какой [режим аутентификации](../../../concepts/connect.md#auth-modes) использовать из следующих источников (в порядке убывания приоритета):
+{{ ydb-short-name }} CLI определяет с какой БД необходимо соединиться и какой [режим аутентификации](../../../concepts/connect.md#auth-modes) использовать из следующих источников (в порядке убывания приоритета):
 
 1. Командной строки
 2. Профиля, выбранного опцией командной строки `--profile`
 3. Переменных окружения
 4. Активированного профиля
 
-Для того чтобы YDB CLI попробовал соединиться с БД, в результате исполнения данных шагов должен быть определен [Эндпоинт](../../../concepts/connect.md#endpoint) и [Размещение базы данных](../../../concepts/connect.md#database).
+Для того чтобы {{ ydb-short-name }} CLI попробовал соединиться с БД, в результате исполнения данных шагов должен быть определен [Эндпоинт](../../../concepts/connect.md#endpoint) и [Размещение базы данных](../../../concepts/connect.md#database).
 
-Если все шаги пройдены, но YDB CLI не определил режим аутентификации, то запросы будут отправляться на сервер YDB без добавления аутентификационных данных. Это может позволить успешно работать с локально развернутыми кластерами YDB, не требующими аутентификации. Для всех доступных по сети баз данных такие запросы будут отклонены сервером с выдачей ошибки аутентификации.
+Если все шаги пройдены, но {{ ydb-short-name }} CLI не определил режим аутентификации, то запросы будут отправляться на сервер {{ ydb-short-name }} без добавления аутентификационных данных. Это может позволить успешно работать с локально развернутыми кластерами {{ ydb-short-name }}, не требующими аутентификации. Для всех доступных по сети баз данных такие запросы будут отклонены сервером с выдачей ошибки аутентификации.
 
-О возможных ситуациях, когда YDB CLI не будет пытаться соединиться с БД, читайте ниже в секции [Сообщения об ошибках](#errors).
+О возможных ситуациях, когда {{ ydb-short-name }} CLI не будет пытаться соединиться с БД, читайте ниже в секции [Сообщения об ошибках](#errors).
 
 ## Параметры командной строки {#command-line-pars}
 
@@ -23,26 +23,26 @@ YDB CLI определяет с какой БД необходимо соеди�
 {{ ydb-cli }} <опции_соединения> <команда> <опции_команды>
 ```
 
-- `-e, --endpoint <endpoint>` : [Эндпоинт](../../../concepts/connect.md#endpoint) - основной параметр соединения, позволяющий найти сервер YDB в сети. Если порт не указан, применяется 2135. Если протокол не указан, то в публичных сборках YDB CLI применяется gRPCs (с шифрованием).
+- `-e, --endpoint <endpoint>` : [Эндпоинт](../../../concepts/connect.md#endpoint) - основной параметр соединения, позволяющий найти сервер {{ ydb-short-name }} в сети. Если порт не указан, применяется 2135. Если протокол не указан, то в публичных сборках {{ ydb-short-name }} CLI применяется gRPCs (с шифрованием).
 - `-d, --database <database>` : [Размещение базы данных](../../../concepts/connect.md#database)
 
 {% include [auth/options.md](auth/options.md) %}
 
 ## Параметры из профиля, выбранного опцией командной строки {#profile}
 
-Если в командной строке при вызове YDB CLI не указан какой-либо параметр соединения, то CLI производит попытку его определения по [профилю](../profile/index.md), выбранному опцией командной строки `--profile`.
+Если в командной строке при вызове {{ ydb-short-name }} CLI не указан какой-либо параметр соединения, то CLI производит попытку его определения по [профилю](../profile/index.md), выбранному опцией командной строки `--profile`.
 
 В профиле может быть определено большинство переменных, аналогичных опциям из раздела [параметры командной строки](#command-line-pars). Обработка их значений производится также как и параметров командной строки. 
 
 ## Параметры из переменных окружения {#env}
 
-Если в командной строке не был явно указан профиль, или в нём не заданы отвечающие за аутентификацию параметры, то YDB CLI пытается определить режим и параметры аутентификации по окружению YDB CLI по следующему алгоритму:
+Если в командной строке не был явно указан профиль, или в нём не заданы отвечающие за аутентификацию параметры, то {{ ydb-short-name }} CLI пытается определить режим и параметры аутентификации по окружению {{ ydb-short-name }} CLI по следующему алгоритму:
 
 {% include [env.md](auth/env.md) %}
 
 ## Параметры из активированного профиля {#activated-profile}
 
-Если на предыдущих шагах не удалось определить какой-либо параметр соединения, и в командной строке не был явно указан профиль опцией `--profile`, то YDB CLI пробует использовать параметры соединения из [активированного профиля](../profile/activate.md).
+Если на предыдущих шагах не удалось определить какой-либо параметр соединения, и в командной строке не был явно указан профиль опцией `--profile`, то {{ ydb-short-name }} CLI пробует использовать параметры соединения из [активированного профиля](../profile/activate.md).
 
 ## Сообщения об ошибках {#errors}
 
@@ -66,4 +66,4 @@ YDB CLI определяет с какой БД необходимо соеди�
 
 ## Проверка аутентификации {#whoami}
 
-Сервисная команда YDB CLI [`discovery whoami`](../commands/discovery-whoami.md) позволяет проверить, под какой учетной записью вы фактически аутентифицировались на сервере.
+Сервисная команда {{ ydb-short-name }} CLI [`discovery whoami`](../commands/discovery-whoami.md) позволяет проверить, под какой учетной записью вы фактически аутентифицировались на сервере.
diff --git a/ydb/docs/ru/core/reference/ydb-cli/_includes/index.md b/ydb/docs/ru/core/reference/ydb-cli/_includes/index.md
index 8c0988d9b8..2ad62c0090 100644
--- a/ydb/docs/ru/core/reference/ydb-cli/_includes/index.md
+++ b/ydb/docs/ru/core/reference/ydb-cli/_includes/index.md
@@ -1,12 +1,12 @@
 # {{ ydb-short-name }} CLI
 
-Интерфейс командной строки {{ ydb-short-name }} CLI — программа для управления вашими данными в YDB.
+Интерфейс командной строки {{ ydb-short-name }} CLI — программа для управления вашими данными в {{ ydb-short-name }}.
 
-Для того чтобы воспользоваться {{ ydb-short-name }} CLI, ознакомьтесь со статьей [Установка YDB CLI](../install.md).
+Для того чтобы воспользоваться {{ ydb-short-name }} CLI, ознакомьтесь со статьей [Установка {{ ydb-short-name }} CLI](../install.md).
 
 При соединении с БД вам потребуется аутентифицироваться. Для первого соединения вы можете воспользоваться быстрым рецептом, приведенным в статье [Аутентификация](../../../getting_started/auth.md) в разделе "Начало работы". 
 
-Полная информация об определении параметров соединения с БД и аутентификации приведена в статье [Соединение с БД и аутентификация YDB CLI](../connect.md) данного раздела.
+Полная информация об определении параметров соединения с БД и аутентификации приведена в статье [Соединение с БД и аутентификация {{ ydb-short-name }} CLI](../connect.md) данного раздела.
 
 Полное описание команд {{ ydb-short-name }} CLI опубликовано в других статьях раздела, включая:
 
diff --git a/ydb/docs/ru/core/reference/ydb-cli/commands/_includes/dir.md b/ydb/docs/ru/core/reference/ydb-cli/commands/_includes/dir.md
index fba0d59e49..045c9d7cb1 100644
--- a/ydb/docs/ru/core/reference/ydb-cli/commands/_includes/dir.md
+++ b/ydb/docs/ru/core/reference/ydb-cli/commands/_includes/dir.md
@@ -1,8 +1,8 @@
 # Директории
 
-База данных YDB поддерживает внутри иерархическую структуру [директорий](../../../../concepts/datamodel.md#dir), в которых могут размещаться объекты БД.
+База данных {{ ydb-short-name }} поддерживает внутри иерархическую структуру [директорий](../../../../concepts/datamodel.md#dir), в которых могут размещаться объекты БД.
 
-YDB CLI поддерживает операции изменения структуры директорий, а также указание директории при обращении к объектам схемы.
+{{ ydb-short-name }} CLI поддерживает операции изменения структуры директорий, а также указание директории при обращении к объектам схемы.
 
 ## Создание директории {#mkdir}
 
diff --git a/ydb/docs/ru/core/reference/ydb-cli/commands/_includes/discovery-list.md b/ydb/docs/ru/core/reference/ydb-cli/commands/_includes/discovery-list.md
index adc811f6a8..3542a0a22a 100644
--- a/ydb/docs/ru/core/reference/ydb-cli/commands/_includes/discovery-list.md
+++ b/ydb/docs/ru/core/reference/ydb-cli/commands/_includes/discovery-list.md
@@ -1,6 +1,6 @@
 # Список эндпоинтов
 
-Информационная команда `discovery list` позволяет получить список [эндпоинтов](../../../../concepts/connect.md#endpoint) кластера YDB, с которыми можно открывать соединения для работы с заданной базой данных:
+Информационная команда `discovery list` позволяет получить список [эндпоинтов](../../../../concepts/connect.md#endpoint) кластера {{ ydb-short-name }}, с которыми можно открывать соединения для работы с заданной базой данных:
 
 ``` bash
 {{ ydb-cli }} [connection options] discovery list
@@ -11,9 +11,9 @@
 В выводимых в ответ строках содержится следующая информация:
 1. Эндпоинт, включая протокол и порт
 2. В квадратных скобках зона доступности
-3. С символом `#` перечень сервисов YDB, доступных на данном эндпоинте
+3. С символом `#` перечень сервисов {{ ydb-short-name }}, доступных на данном эндпоинте
 
-Запрос к кластеру YDB на endpoint discovery выполняется в YDB SDK при инициализации драйвера, и команду CLI `discovery list` можно использовать для локализации возможных проблем соединения.
+Запрос к кластеру {{ ydb-short-name }} на endpoint discovery выполняется в {{ ydb-short-name }} SDK при инициализации драйвера, и команду CLI `discovery list` можно использовать для локализации возможных проблем соединения.
 
 ## Пример
 
diff --git a/ydb/docs/ru/core/reference/ydb-cli/commands/_includes/discovery-whoami.md b/ydb/docs/ru/core/reference/ydb-cli/commands/_includes/discovery-whoami.md
index d8ea4e3b62..3ea4f59c9e 100644
--- a/ydb/docs/ru/core/reference/ydb-cli/commands/_includes/discovery-whoami.md
+++ b/ydb/docs/ru/core/reference/ydb-cli/commands/_includes/discovery-whoami.md
@@ -10,7 +10,7 @@
 
 В ответ выводится имя учетной записи (User SID) и, если указана опция `-g`, то информация о принадлежности учетной записи группам.
 
-Если на сервере YDB не включена аутентификация (что может применяться, например, при самостоятельном локальном развертывании), то выполнение команды завершится с ошибкой.
+Если на сервере {{ ydb-short-name }} не включена аутентификация (что может применяться, например, при самостоятельном локальном развертывании), то выполнение команды завершится с ошибкой.
 
 Поддержка опции `-g` зависит от конфигурации сервера. Если она не включена, то вы будете получать в ответ `User has no groups` вне зависимости от фактического включения вашей учетной записи в какие-либо группы.
 
diff --git a/ydb/docs/ru/core/reference/ydb-cli/commands/_includes/global-options.md b/ydb/docs/ru/core/reference/ydb-cli/commands/_includes/global-options.md
index 27c6aef8e3..84ca039e3a 100644
--- a/ydb/docs/ru/core/reference/ydb-cli/commands/_includes/global-options.md
+++ b/ydb/docs/ru/core/reference/ydb-cli/commands/_includes/global-options.md
@@ -6,5 +6,5 @@
 
 ## Сервисные опции {#service-options}
 
-- `--profile <name>` : Указывает на использование профиля соединения с БД с заданным именем при выполнении какой-либо команды YDB CLI. В профиле может быть сохранено большинство параметров соединения.
+- `--profile <name>` : Указывает на использование профиля соединения с БД с заданным именем при выполнении какой-либо команды {{ ydb-short-name }} CLI. В профиле может быть сохранено большинство параметров соединения.
 - `-v, --verbose` : Вывод детальной информации обо всех выполняемых операциях. Указание данной опции полезно для локализации проблем при соединении с БД.
diff --git a/ydb/docs/ru/core/reference/ydb-cli/commands/_includes/service.md b/ydb/docs/ru/core/reference/ydb-cli/commands/_includes/service.md
index 4c09756096..153b0224cc 100644
--- a/ydb/docs/ru/core/reference/ydb-cli/commands/_includes/service.md
+++ b/ydb/docs/ru/core/reference/ydb-cli/commands/_includes/service.md
@@ -1,13 +1,13 @@
 # Сервисные команды
 
-Данные команды относятся к самому клиентскому приложению YDB CLI, и не предполагают установки соединения с БД. Они могут быть выражены как в виде параметра, так и в виде опции.
+Данные команды относятся к самому клиентскому приложению {{ ydb-short-name }} CLI, и не предполагают установки соединения с БД. Они могут быть выражены как в виде параметра, так и в виде опции.
 
 Имя | Описание
 --- | ---
-`-?`, `-h`, `--help` | Вывод справки о синтаксисе YDB CLI
-`version` | Вывод информации о версии YDB CLI (для публичных сборок)
-`update` | Обновление YDB CLI до последней версии (для публичных сборок)
+`-?`, `-h`, `--help` | Вывод справки о синтаксисе {{ ydb-short-name }} CLI
+`version` | Вывод информации о версии {{ ydb-short-name }} CLI (для публичных сборок)
+`update` | Обновление {{ ydb-short-name }} CLI до последней версии (для публичных сборок)
 `--license` | Показать лицензию (для публичных сборок)
 `--credits` | Показать лицензии сторонних продуктов (для публичных сборок)
 
-Если неизвестно, является ли используемая сборка YDB CLI публичной, то уточнить поддержку той или иной сервисной команды в ней можно вызовом справки.
+Если неизвестно, является ли используемая сборка {{ ydb-short-name }} CLI публичной, то уточнить поддержку той или иной сервисной команды в ней можно вызовом справки.
diff --git a/ydb/docs/ru/core/reference/ydb-cli/profile/_includes/activate.md b/ydb/docs/ru/core/reference/ydb-cli/profile/_includes/activate.md
index f264ee9edd..ec09007969 100644
--- a/ydb/docs/ru/core/reference/ydb-cli/profile/_includes/activate.md
+++ b/ydb/docs/ru/core/reference/ydb-cli/profile/_includes/activate.md
@@ -1,8 +1,8 @@
 # Активированный профиль
 
-Исполнение команд YDB CLI над базой данных требует установки соединения с ней. Если YDB CLI не удалось определить какой-либо параметр соединения по [параметрам командной строки и переменным окружения](../../connect.md), он берется из активированного профиля.
+Исполнение команд {{ ydb-short-name }} CLI над базой данных требует установки соединения с ней. Если {{ ydb-short-name }} CLI не удалось определить какой-либо параметр соединения по [параметрам командной строки и переменным окружения](../../connect.md), он берется из активированного профиля.
 
-Активация профиля является простым способом начать изучение YDB CLI, так как один раз заданные параметры соединения будут применяться автоматически к любой команде, без указания каких-либо параметров соединения в командной строке.
+Активация профиля является простым способом начать изучение {{ ydb-short-name }} CLI, так как один раз заданные параметры соединения будут применяться автоматически к любой команде, без указания каких-либо параметров соединения в командной строке.
 
 Однако, данная простота может приводить к нежелательному поведению в дальнейшей работе, как только возникнет необходимость работы с несколькими базами данных:
 
@@ -68,7 +68,7 @@ Activate profile "<profile_name>" to use by default? (current active profile is
 
 ## Деактивация профиля {#deactivate}
 
-YDB CLI в настоящее время поддерживает деактивацию профиля только в интерактивном режиме при вызове команды активации без указания профиля (выбор пункта `2` в описанной выше [команде активации](#activate)).
+{{ ydb-short-name }} CLI в настоящее время поддерживает деактивацию профиля только в интерактивном режиме при вызове команды активации без указания профиля (выбор пункта `2` в описанной выше [команде активации](#activate)).
 
 При необходимости вы можете использовать перенаправление ввода операционной системы для автоматического выбора опции `2` в интерактивном вводе:
 
diff --git a/ydb/docs/ru/core/reference/ydb-cli/profile/_includes/create.md b/ydb/docs/ru/core/reference/ydb-cli/profile/_includes/create.md
index 5ab0663c2e..9dfb1370a1 100644
--- a/ydb/docs/ru/core/reference/ydb-cli/profile/_includes/create.md
+++ b/ydb/docs/ru/core/reference/ydb-cli/profile/_includes/create.md
@@ -36,7 +36,7 @@
    Please enter name for a new profile: 
    ```
 
-   Если ввести в этот момент имя существующего профиля, то YDB CLI переходит к шагам изменения его параметров, как если бы сразу была выбрана опция с именем этого профиля.
+   Если ввести в этот момент имя существующего профиля, то {{ ydb-short-name }} CLI переходит к шагам изменения его параметров, как если бы сразу была выбрана опция с именем этого профиля.
 
 - Profile Create
 
diff --git a/ydb/docs/ru/core/reference/ydb-cli/profile/_includes/delete.md b/ydb/docs/ru/core/reference/ydb-cli/profile/_includes/delete.md
index 3255be2554..a57411a262 100644
--- a/ydb/docs/ru/core/reference/ydb-cli/profile/_includes/delete.md
+++ b/ydb/docs/ru/core/reference/ydb-cli/profile/_includes/delete.md
@@ -8,7 +8,7 @@
 
 , где `<profile_name>` - имя профиля.
 
-YDB CLI запросит подтверждение удаления профиля:
+{{ ydb-short-name }} CLI запросит подтверждение удаления профиля:
 
 ``` text
 Profile "<profile_name>" will be permanently removed. Continue? (y/n): 
@@ -28,7 +28,7 @@ Profile "mydb1" was removed.
 
 ## Удаление профиля без интерактивного ввода {#non-interactive}
 
-Хотя данный режим не поддерживается YDB CLI, при необходимости вы можете использовать перенаправление ввода операционной системы для автоматического ответа `y` на вопрос подтверждения удаления:
+Хотя данный режим не поддерживается {{ ydb-short-name }} CLI, при необходимости вы можете использовать перенаправление ввода операционной системы для автоматического ответа `y` на вопрос подтверждения удаления:
 
 ``` bash
 echo y | {{ ydb-cli }} config profile delete my_profile
diff --git a/ydb/docs/ru/core/reference/ydb-cli/profile/_includes/use.md b/ydb/docs/ru/core/reference/ydb-cli/profile/_includes/use.md
index d05debc85b..2854433693 100644
--- a/ydb/docs/ru/core/reference/ydb-cli/profile/_includes/use.md
+++ b/ydb/docs/ru/core/reference/ydb-cli/profile/_includes/use.md
@@ -2,7 +2,7 @@
 
 ## Соединение по выбранному профилю {#explicit}
 
-Профиль может быть применен при запуске команды YDB CLI указанием опции `--profile <profile_name>`:
+Профиль может быть применен при запуске команды {{ ydb-short-name }} CLI указанием опции `--profile <profile_name>`:
 
 ``` bash
 {{ ydb-cli }} --profile <profile_name> <команда и опции команды>
@@ -14,7 +14,7 @@
 {{ ydb-cli }} --profile mydb1 scheme ls -l
 ```
 
-В таком случае все параметры соединения с БД будут взяты из профиля. При этом, если в профиле не указано параметров аутентификации, то YDB CLI попробует их определить по переменным окружения, как описано в статье [Соединение с БД и аутентификация - Переменные окружения](../../connect.md#env).
+В таком случае все параметры соединения с БД будут взяты из профиля. При этом, если в профиле не указано параметров аутентификации, то {{ ydb-short-name }} CLI попробует их определить по переменным окружения, как описано в статье [Соединение с БД и аутентификация - Переменные окружения](../../connect.md#env).
 
 ## Соединение по выбранному профилю и параметрам командной строки {#explicit-and-pars}
 
@@ -32,6 +32,6 @@
 
 ## Соединение по активированному профилю {#implicit}
 
-Если в командной строке не указана опция `--profile`, то YDB CLI попробует взять из текущего активированного профиля все параметры соединения, которые он не смог определить другими способами (из опций командной строки или переменных окружения, как описано в статье [Соединение с БД и аутентификация](../../connect.md)).
+Если в командной строке не указана опция `--profile`, то {{ ydb-short-name }} CLI попробует взять из текущего активированного профиля все параметры соединения, которые он не смог определить другими способами (из опций командной строки или переменных окружения, как описано в статье [Соединение с БД и аутентификация](../../connect.md)).
 
 Неявное применение активированного профиля может приводить к ошибкам, поэтому перед использованием данного режима рекомендуется изучить статью [Активированный профиль](../activate.md).
 \ No newline at end of file
diff --git a/ydb/docs/ru/core/reference/ydb-sdk/_includes/auth.md b/ydb/docs/ru/core/reference/ydb-sdk/_includes/auth.md
index 27ad1a08e5..d017bd466d 100644
--- a/ydb/docs/ru/core/reference/ydb-sdk/_includes/auth.md
+++ b/ydb/docs/ru/core/reference/ydb-sdk/_includes/auth.md
@@ -1,15 +1,15 @@
 # Аутентификация при соединении SDK с БД
 
-Как описано в статье о [подключении клиента YDB к серверу и аутентификации](../../../concepts/connect.md), для успешной аутентификации в запрос клиентом должен быть добавлен аутентификационный токен, проверяемый сервером.
+Как описано в статье о [подключении клиента {{ ydb-short-name }} к серверу и аутентификации](../../../concepts/connect.md), для успешной аутентификации в запрос клиентом должен быть добавлен аутентификационный токен, проверяемый сервером.
 
-YDB SDK использует объект, отвечающий за генерацию таких токенов. SDK предоставляет встроенные методы получения такого объекта:
+{{ ydb-short-name }} SDK использует объект, отвечающий за генерацию таких токенов. SDK предоставляет встроенные методы получения такого объекта:
 
 1. Специализированные методы под разные [режимы аутентификации](../../../concepts/connect.md#auth-modes) с явной передачей параметров.
 2. Метод определения режима аутентификации и необходимых параметров из окружения, в котором запускается приложение.
 
-Обычно объект генерации токенов создается перед инициализацией драйвера YDB, и передается параметром в его конструктор. C++ и Go SDK дополнительно позволяют через один драйвер работать с несколькими БД и объектами генерации токенов.
+Обычно объект генерации токенов создается перед инициализацией драйвера {{ ydb-short-name }}, и передается параметром в его конструктор. C++ и Go SDK дополнительно позволяют через один драйвер работать с несколькими БД и объектами генерации токенов.
 
-Если объект генерации токенов не определен, драйвер не будет добавлять в запросы какой-либо аутентификационной информации, что может позволить успешно соединиться с локально развернутыми кластерами YDB, не требующими аутентификации. Для всех доступных по сети баз данных такие запросы будут отклонены с выдачей ошибки аутентификации.
+Если объект генерации токенов не определен, драйвер не будет добавлять в запросы какой-либо аутентификационной информации, что может позволить успешно соединиться с локально развернутыми кластерами {{ ydb-short-name }}, не требующими аутентификации. Для всех доступных по сети баз данных такие запросы будут отклонены с выдачей ошибки аутентификации.
 
 ## Методы создания объекта генерации токенов {#auth-provider}
 
diff --git a/ydb/docs/ru/core/reference/ydb-sdk/_includes/index/examples.md b/ydb/docs/ru/core/reference/ydb-sdk/_includes/index/examples.md
new file mode 100644
index 0000000000..e69de29bb2
--- /dev/null
+++ b/ydb/docs/ru/core/reference/ydb-sdk/_includes/index/examples.md
diff --git a/ydb/docs/ru/core/reference/ydb-sdk/_includes/index/intro.md b/ydb/docs/ru/core/reference/ydb-sdk/_includes/index/intro.md
new file mode 100644
index 0000000000..e69de29bb2
--- /dev/null
+++ b/ydb/docs/ru/core/reference/ydb-sdk/_includes/index/intro.md
diff --git a/ydb/docs/ru/core/reference/ydb-sdk/example/_includes/example-go.md b/ydb/docs/ru/core/reference/ydb-sdk/example/_includes/example-go.md
index c4157512c9..8d71eee7ce 100644
--- a/ydb/docs/ru/core/reference/ydb-sdk/example/_includes/example-go.md
+++ b/ydb/docs/ru/core/reference/ydb-sdk/example/_includes/example-go.md
@@ -7,7 +7,7 @@
 
 {% include [init.md](steps/01_init.md) %}
 
-Для работы с `YDB` в `go` следует импортировать пакет драйвера `ydb-go-sdk`:
+Для работы с {{ ydb-short-name }} в `go` следует импортировать пакет драйвера `ydb-go-sdk`:
 
 ```go
 import (
@@ -54,7 +54,7 @@ defer func() {
 }()
 ```
 
-Объект `db` является входной точкой для работы с сервисами `YDB`.
+Объект `db` является входной точкой для работы с сервисами {{ ydb-short-name }}.
 Для работы сервисом таблиц следует использовать клиента table-сервиса `db.Table()`.
 Клиент table-сервиса предоставляет `API` для выполнения запросов над таблицами.
 Наиболее востребован метод `db.Table().Do(ctx, op)`, который реализует фоновое создание сессий и повторные попытки выполнить пользовательскую операцию `op`, в которую пользовательскому коду отдается подготовленная сессия.
diff --git a/ydb/docs/ru/core/reference/ydb-sdk/example/_includes/index.md b/ydb/docs/ru/core/reference/ydb-sdk/example/_includes/index.md
index 1a8d452d0a..fa5a4b70ab 100644
--- a/ydb/docs/ru/core/reference/ydb-sdk/example/_includes/index.md
+++ b/ydb/docs/ru/core/reference/ydb-sdk/example/_includes/index.md
@@ -1,6 +1,6 @@
 # Тестовое приложение
 
-В данном разделе разбирается код однотипного тестового приложения, реализованного с использованием YDB SDK на разных языках программирования:
+В данном разделе разбирается код однотипного тестового приложения, реализованного с использованием {{ ydb-short-name }} SDK на разных языках программирования:
 
 {% if oss %}
 - [C++](../example-cpp.md)
diff --git a/ydb/docs/ru/core/reference/ydb-sdk/example/archive/example-go-v1.md b/ydb/docs/ru/core/reference/ydb-sdk/example/archive/example-go-v1.md
index 636aef5445..06ee09e092 100644
--- a/ydb/docs/ru/core/reference/ydb-sdk/example/archive/example-go-v1.md
+++ b/ydb/docs/ru/core/reference/ydb-sdk/example/archive/example-go-v1.md
@@ -4,7 +4,7 @@
 
 {% include [init.md](../_includes/steps/01_init.md) %}
 
-Для работы с `YDB` в `go` следует импортировать пакет драйвера `ydb-go-sdk`:
+Для работы с {{ ydb-short-name }} в `go` следует импортировать пакет драйвера `ydb-go-sdk`:
 
 ```go
 import (
diff --git a/ydb/docs/ru/core/reference/ydb-sdk/example/archive/example-go-v2.md b/ydb/docs/ru/core/reference/ydb-sdk/example/archive/example-go-v2.md
index 07c22e3ece..b7162d55aa 100644
--- a/ydb/docs/ru/core/reference/ydb-sdk/example/archive/example-go-v2.md
+++ b/ydb/docs/ru/core/reference/ydb-sdk/example/archive/example-go-v2.md
@@ -4,7 +4,7 @@
 
 {% include [init.md](../_includes/steps/01_init.md) %}
 
-Для работы с `YDB` в `go` следует импортировать пакет драйвера `ydb-go-sdk`:
+Для работы с {{ ydb-short-name }} в `go` следует импортировать пакет драйвера `ydb-go-sdk`:
 
 ```go
 import (
diff --git a/ydb/docs/ru/core/reference/ydb-sdk/recipes/_includes/index.md b/ydb/docs/ru/core/reference/ydb-sdk/recipes/_includes/index.md
index dbdd275f61..6b1debd560 100644
--- a/ydb/docs/ru/core/reference/ydb-sdk/recipes/_includes/index.md
+++ b/ydb/docs/ru/core/reference/ydb-sdk/recipes/_includes/index.md
@@ -2,4 +2,4 @@
 
 {% include [work in progress message](addition.md) %}
 
-В данном разделе содержатся рецепты кода на разных языках программирования для решения различных задач, часто-встречающихся на практике, с использованием YDB SDK.
+В данном разделе содержатся рецепты кода на разных языках программирования для решения различных задач, часто-встречающихся на практике, с использованием {{ ydb-short-name }} SDK.
diff --git a/ydb/docs/ru/core/reference/ydb-sdk/recipes/session_pool_limit/index.md b/ydb/docs/ru/core/reference/ydb-sdk/recipes/session_pool_limit/index.md
index b48644de25..57d7bc22eb 100644
--- a/ydb/docs/ru/core/reference/ydb-sdk/recipes/session_pool_limit/index.md
+++ b/ydb/docs/ru/core/reference/ydb-sdk/recipes/session_pool_limit/index.md
@@ -2,7 +2,7 @@
 
 {% include [work in progress message](../_includes/addition.md) %}
 
-Размер пула сессий на клиенте влияет на потребление ресурсов (память, процессор) на серверной стороне YDB.
+Размер пула сессий на клиенте влияет на потребление ресурсов (память, процессор) на серверной стороне {{ ydb-short-name }}.
 Простая математика: если `1000` клиентов одной базы данных имеют по `1000` сессий, то на серверной стороне создается `100000` акторов (воркеров, исполнителей сессий). Если не лимитировать количество сессий на клиенте, то можно получить "задумчивый" кластер в полу-аварийном состоянии.
 По умолчанию в `Ydb SDK` установлен лимит в `50` сессий.
 Хорошая рекомендация - устанавливать лимит на количество сессий на клиенте в минимальное-необходимое для штатной работы клиентского приложения. Следует иметь в виду, что сессия однопоточная что на серверной стороне, что на клиентской. Соответственно, если для расчетной нагрузки приложению необходимо выполнять  `1000` одновременных запросов (`inflight`) в `Ydb` - значит следует установить лимит в `1000` сессий.
diff --git a/ydb/docs/ru/core/toc_p.yaml b/ydb/docs/ru/core/toc_p.yaml
index 762b9b82ac..b3bc4402e0 100644
--- a/ydb/docs/ru/core/toc_p.yaml
+++ b/ydb/docs/ru/core/toc_p.yaml
@@ -1,4 +1,4 @@
-title: Yandex Database
+title: YDB
 href: index.yaml
 items:
 - include: { mode: link, path: toc_i.yaml }
 \ No newline at end of file
diff --git a/ydb/docs/ru/core/troubleshooting/_includes/monitoring_sensors.md b/ydb/docs/ru/core/troubleshooting/_includes/monitoring_sensors.md
index 56bd2e5aa4..4142db3bcf 100644
--- a/ydb/docs/ru/core/troubleshooting/_includes/monitoring_sensors.md
+++ b/ydb/docs/ru/core/troubleshooting/_includes/monitoring_sensors.md
@@ -1,4 +1,4 @@
-## Сервис {{ ydb-full-name }} {#ydb}
+## Сервис {{ ydb-short-name }} {#ydb}
 
 ### Метрики использования ресурсов {#resources}
 
diff --git a/ydb/docs/ru/overlay/reference/ydb-cli/_includes/auth/options.md b/ydb/docs/ru/overlay/reference/ydb-cli/_includes/auth/options.md
index 9738b81503..b752dcbf10 100644
--- a/ydb/docs/ru/overlay/reference/ydb-cli/_includes/auth/options.md
+++ b/ydb/docs/ru/overlay/reference/ydb-cli/_includes/auth/options.md
@@ -1,4 +1,4 @@
-OpenSource сборка YDB CLI поддерживает только один режим аутентификации -- по логину и паролю:
+OpenSource сборка {{ ydb-short-name }} CLI поддерживает только один режим аутентификации -- по логину и паролю:
 
 {% include [options_static.md](options_static.md) %}
 
diff --git a/ydb/docs/ru/overlay/reference/ydb-cli/_includes/install_overlay.md b/ydb/docs/ru/overlay/reference/ydb-cli/_includes/install_overlay.md
index f673dc20e4..0cace74469 100644
--- a/ydb/docs/ru/overlay/reference/ydb-cli/_includes/install_overlay.md
+++ b/ydb/docs/ru/overlay/reference/ydb-cli/_includes/install_overlay.md
@@ -1,4 +1,3 @@
-OpenSource версия YDB CLI может быть собрана из исходного кода. В настоящее время она поддерживает только аутентификацию по логину и паролю.
-
-Также для работы с любыми базами данных YDB (включая OpenSource сборки) можно использовать Yandex Cloud версию YDB CLI, которая поддерживает все виды аутентификации, включая логин и пароль. Порядок установки этой версии описан ниже.
+OpenSource версия {{ ydb-short-name }} CLI может быть собрана из исходного кода. В настоящее время она поддерживает только аутентификацию по логину и паролю.
 
+Также для работы с любыми базами данных {{ ydb-short-name }} (включая OpenSource сборки) можно использовать Yandex Cloud версию {{ ydb-short-name }} CLI, которая поддерживает все виды аутентификации, включая логин и пароль. Порядок установки этой версии описан ниже.
diff --git a/ydb/docs/ru/overlay/toc_p.yaml b/ydb/docs/ru/overlay/toc_p.yaml
index 762b9b82ac..b3bc4402e0 100644
--- a/ydb/docs/ru/overlay/toc_p.yaml
+++ b/ydb/docs/ru/overlay/toc_p.yaml
@@ -1,4 +1,4 @@
-title: Yandex Database
+title: YDB
 href: index.yaml
 items:
 - include: { mode: link, path: toc_i.yaml }
 \ No newline at end of file
author	bazeltsev <bazeltsev@yandex-team.ru>	2022-02-23 14:02:04 +0300
committer	bazeltsev <bazeltsev@yandex-team.ru>	2022-02-23 14:02:04 +0300
commit	cd5c4d9254f66cc8ea5753a83971e35cc32c1526 (patch)
tree	8acb3a2bd4d6766ed107f6a225146e6523af99b6
parent	eb3d75399185dcb1bf88ae2360fddbbfe9429390 (diff)
download	ydb-cd5c4d9254f66cc8ea5753a83971e35cc32c1526.tar.gz