Локализовать ссылки в core

copy to kikimr

updated

ref:4e8b9a42f526c71d7f9585a6b7eb48e0e0023fb4

14 files changed, 23 insertions, 23 deletions

diff --git a/ydb/docs/ru/core/concepts/_includes/connect.md b/ydb/docs/ru/core/concepts/_includes/connect.md
index 94bf8655253..532b62d27fc 100644
--- a/ydb/docs/ru/core/concepts/_includes/connect.md
+++ b/ydb/docs/ru/core/concepts/_includes/connect.md
@@ -61,7 +61,7 @@
 
 ## Размещение базы данных {#database}
 
-Размещение базы данных (`database`) - строка, определяющая где на кластере {{ ydb-short-name }} находится база данных, к которой адресован запрос. Имеет структуру [пути к файлу](https://ru.wikipedia.org/wiki/Путь_к_файлу), с использованием символа `/` в качестве разделителя. Начинается всегда с символа `/`.
+Размещение базы данных (`database`) - строка, определяющая где на кластере {{ ydb-short-name }} находится база данных, к которой адресован запрос. Имеет структуру [пути к файлу]{% if lang == "en" %}(https://en.wikipedia.org/wiki/Path_(computing)){% endif %}{% if lang == "ru" %}(https://ru.wikipedia.org/wiki/Путь_к_файлу){% endif %}, с использованием символа `/` в качестве разделителя. Начинается всегда с символа `/`.
 
 На кластере {{ ydb-short-name }} может быть развернуто множество баз данных, и их размещение определяется конфигурацией кластера. Как и эндпоинт, для облачных баз данных `database` показывается в консоли управления на странице требуемой БД, а также обычно может быть получено через CLI облачного поставщика.
 
@@ -92,12 +92,12 @@
 
 ### Корневой сертификат для TLS {#tls-cert}
 
-При использовании протокола с шифрованием ([gRPC over TLS](https://grpc.io/docs/guides/auth/), или grpcs) продолжение сетевого соединения возможно только в том случае, если клиент уверен в том, что ему действительно отвечает подлинный сервер, с которым он пытается установить соединение, а не кто-то посередине, перехвативший запрос в сети. Это обеспечивается проверкой через [цепочки доверия](https://ru.wikipedia.org/wiki/Цепочка_доверия), для работы которой на клиенте должен быть установлен т.н. корневой сертификат.
+При использовании протокола с шифрованием ([gRPC over TLS](https://grpc.io/docs/guides/auth/), или grpcs) продолжение сетевого соединения возможно только в том случае, если клиент уверен в том, что ему действительно отвечает подлинный сервер, с которым он пытается установить соединение, а не кто-то посередине, перехвативший запрос в сети. Это обеспечивается проверкой через [цепочки доверия]{% if lang == "en" %}(https://en.wikipedia.org/wiki/Chain_of_trust){% endif %}{% if lang == "ru" %}(https://ru.wikipedia.org/wiki/Цепочка_доверия){% endif %}, для работы которой на клиенте должен быть установлен т.н. корневой сертификат.
 
 В состав операционных систем, на которых запускается клиент, уже входит набор корневых сертификатов от основных мировых центров сертификации. Однако, владелец кластера {{ ydb-short-name }} может использовать свой центр сертификации, не связанный ни с одним из мировых, что часто встречается в корпоративных окружениях, и почти всегда применяется при самостоятельном развертывании кластеров с поддержкой шифрования на соединениях. В этом случае владелец кластера должен каким-либо образом передать свой корневой сертификат для использования на стороне клиента. Такой сертификат может быть установлен в хранилище сертификатов операционной системы, где запускается клиент (вручную пользователем или корпоративной командой администраторов ОС), или встроен в состав самого клиента (как это сделано для Yandex.Cloud в {{ ydb-short-name }} CLI и SDK).
 
 ### API получения токенов IAM {#token-refresh-api}
 
-Для ротации токенов {{ 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-short-name }} SDK и CLI используют gRPC-запрос к Yandex.Cloud IAM API [IamToken - create]{% if lang == "en" %}(https://cloud.yandex.com/en/docs/iam/api-ref/grpc/iam_token_service#Create){% endif %}{% if lang == "ru" %}(https://cloud.yandex.ru/docs/iam/api-ref/grpc/iam_token_service#Create){% endif %}. В режиме **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 позволяют подменить хост для обращения к API получения токенов, что дает возможность реализовать аналогичный API в корпоративных контекстах.
\ 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 8fe15e2f64d..8e6b06591ab 100644
--- a/ydb/docs/ru/core/concepts/_includes/transactions.md
+++ b/ydb/docs/ru/core/concepts/_includes/transactions.md
@@ -25,7 +25,7 @@
 Ниже перечислены возможности и ограничения поддержки YQL в {{ ydb-short-name }}, которые могут быть неочевидны на первый взгляд и на которые стоит обратить внимание.
 
  * Допускаются multistatement transactions, то есть транзакции, состоящие из последовательности выражений YQL. При выполнении транзакции допускается взаимодействие с клиентской программой, иначе говоря, взаимодействие клиента с базой может выглядеть следующим образом: `BEGIN; выполнить SELECT; проанализировать результаты SELECT на клиенте; ...; выполнить UPDATE; COMMIT`. Стоит отметить, что если тело транзакции полностью сформировано до обращения к базе данных, то транзакция может обрабатываться эффективнее.
- * В {{ ydb-short-name }} не поддерживается возможность смешивать DDL и DML запросы в одной транзакции. Традиционное понятие [ACID](https://ru.wikipedia.org/wiki/ACID) транзакции применимо именно к DML запросам, то есть к запросам, которые меняют данные. DDL запросы должны быть идемпотентными, то есть повторяемы в случае ошибки. Если необходимо выполнить действие со схемой, то каждое из действий будет транзакционно, а набор действий - нет.
+ * В {{ ydb-short-name }} не поддерживается возможность смешивать DDL и DML запросы в одной транзакции. Традиционное понятие [ACID]{% if lang == "en" %}(https://en.wikipedia.org/wiki/ACID){% endif %}{% if lang == "ru" %}(https://ru.wikipedia.org/wiki/ACID){% endif %} транзакции применимо именно к DML запросам, то есть к запросам, которые меняют данные. DDL запросы должны быть идемпотентными, то есть повторяемы в случае ошибки. Если необходимо выполнить действие со схемой, то каждое из действий будет транзакционно, а набор действий - нет.
  * Реализация YQL в {{ ydb-short-name }} использует механизм [Optimistic Concurrency Control](https://en.wikipedia.org/wiki/Optimistic_concurrency_control). На затронутые в ходе транзакции сущности ставятся оптимистичные блокировки, при завершении транзакции проверяется, что блокировки не были инвалидированы. Оптимистичность блокировок выливается в важное для пользователя свойство — в случае конфликта выигрывает транзакция, которая завершается первой. Конкурирующие транзакции завершатся с ошибкой ```Transaction locks invalidated```.
  * Все изменения, производимые в рамках транзакции, накапливаются в памяти сервера базы данных и применяются в момент завершения транзакции. Если взятые блокировки не были инвалидированы, то все накопленные изменения применяются атомарно, если хотя бы одна блокировка была инвалидирована, то ни одно из изменений не будет применено. Описанная схема накладывает некоторые ограничения: объем изменений осуществляемых в рамках одной транзакции должен умещаться в память и транзакция "не видит" своих изменений.
 
diff --git a/ydb/docs/ru/core/concepts/_includes/ttl.md b/ydb/docs/ru/core/concepts/_includes/ttl.md
index d0dead16e9a..c2828bef1fb 100644
--- a/ydb/docs/ru/core/concepts/_includes/ttl.md
+++ b/ydb/docs/ru/core/concepts/_includes/ttl.md
@@ -47,7 +47,7 @@ expiration_time = valueof(ttl_column) + expire_after_seconds
   - `Uint32`;
   - `Uint64`;
   - `DyNumber`.
-* Значение TTL-колонки с числовым типом (`Uint32`, `Uint64`, `DyNumber`) интерпретируется как величина от [Unix-эпохи](https://ru.wikipedia.org/wiki/Unix-время) заданная в:
+* Значение TTL-колонки с числовым типом (`Uint32`, `Uint64`, `DyNumber`) интерпретируется как величина от [Unix-эпохи]{% if lang == "en" %}(https://en.wikipedia.org/wiki/Unix_time){% endif %}{% if lang == "ru" %}(https://ru.wikipedia.org/wiki/Unix-время){% endif %} заданная в:
   - секундах;
   - миллисекундах;
   - микросекундах;
@@ -60,7 +60,7 @@ expiration_time = valueof(ttl_column) + expire_after_seconds
 Управление настройками TTL в настоящий момент возможно с использованием:
 
 * [YQL](../../yql/reference/index.md)
-* [Консольного клиента {{ ydb-short-name }}]{% if audience != "external" %}(https://cloud.yandex.ru/docs/ydb/quickstart/yql-api/ydb-cli){% else %}(../../quickstart/yql-api/ydb-cli.md){% endif %}.
+* [Консольного клиента {{ ydb-short-name }}](../../reference/ydb-cli/index.md).
 * {{ ydb-short-name }} {% if oss %}C++ и{% endif %}  Python [SDK](../../reference/ydb-sdk/index.md)
 
 {% note info %}
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 f23b18ceb16..feff2fc5ecb 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
@@ -197,7 +197,7 @@
       └─────────┘
       ```
 
-      Подробнее о командах {{ ydb-short-name }} CLI читайте в [документации](https://cloud.yandex.ru/docs/ydb/oss/public/reference/ydb-cli/commands/).
+      Подробнее о командах {{ ydb-short-name }} CLI читайте в [документации](../../../reference/ydb-cli/index.md).
 
 {% endlist %}
 
diff --git a/ydb/docs/ru/core/deploy/orchestrated/aws_eks.md b/ydb/docs/ru/core/deploy/orchestrated/aws_eks.md
index 9b6b7e843d0..fd568ddd427 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-short-name }} в AWS EKS
 
-Чтобы с помощью [{{ k8s }}](https://kubernetes.io/) создать кластер [{{ ydb-short-name }}](https://cloud.yandex.ru/docs/ydb/), выполните следующие действия.
+Чтобы с помощью [{{ k8s }}](https://kubernetes.io/) создать кластер [{{ ydb-short-name }}]{% if lang == "en" %}(https://cloud.yandex.com/en/docs/ydb/){% endif %}{% if lang == "ru" %}(https://cloud.yandex.ru/docs/ydb/){% endif %}, выполните следующие действия.
 
 ## Перед началом работы {#before-begin}
 
diff --git a/ydb/docs/ru/core/deploy/orchestrated/concepts.md b/ydb/docs/ru/core/deploy/orchestrated/concepts.md
index 26722e6ab30..e60c980aae5 100644
--- a/ydb/docs/ru/core/deploy/orchestrated/concepts.md
+++ b/ydb/docs/ru/core/deploy/orchestrated/concepts.md
@@ -9,7 +9,7 @@
 1. Установлена утилита kubectl и настроен доступ к кластеру.
 1. Поддерживается динамическое предоставление томов в кластере ([Dynamic Volume Provisioning](https://kubernetes.io/docs/concepts/storage/dynamic-provisioning/)).
 
-Подробнее о Helm читайте в [документации](https://helm.sh/ru/docs/).
+Подробнее о Helm читайте в [документации]{% if lang == "en" %}(https://helm.sh/docs/){% endif %}{% if lang == "ru" %}(https://helm.sh/ru/docs/){% endif %}.
 
 Helm-чарт устанавливает в кластер {{ k8s }} контроллер, который реализует необходимую логику для развертывания компонентов {{ ydb-short-name }}. Контроллер построен по паттерну [Оператор](https://kubernetes.io/docs/concepts/extend-kubernetes/operator/).
 
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 8c8b0c51a0f..bc6a2e9d353 100644
--- a/ydb/docs/ru/core/deploy/orchestrated/yc_managed_kubernetes.md
+++ b/ydb/docs/ru/core/deploy/orchestrated/yc_managed_kubernetes.md
@@ -1,12 +1,12 @@
 # Развертывание {{ ydb-short-name }} в {{ managed-k8s-name }}
 
-Чтобы с помощью [{{ k8s }}](https://kubernetes.io/) создать кластер [{{ ydb-short-name }}](https://cloud.yandex.ru/docs/ydb/), выполните следующие действия.
+Чтобы с помощью [{{ k8s }}](https://kubernetes.io/) создать кластер [{{ ydb-short-name }}]{% if lang == "en" %}(https://cloud.yandex.com/en/docs/ydb/){% endif %}{% if lang == "ru" %}(https://cloud.yandex.ru/docs/ydb/){% endif %}, выполните следующие действия.
 
 ## Перед началом работы {#before-begin}
 
 1. Создайте кластер {{ k8s }}.
 
-    Вы можете использовать уже работающий кластер {{ k8s }} или [создать](https://cloud.yandex.ru/docs/managed-kubernetes/operations/kubernetes-cluster/kubernetes-cluster-create) новый.
+    Вы можете использовать уже работающий кластер {{ k8s }} или [создать]{% if lang == "en" %}(https://cloud.yandex.com/en/docs/managed-kubernetes/operations/kubernetes-cluster/kubernetes-cluster-create){% endif %}{% if lang == "ru" %}(https://cloud.yandex.ru/docs/managed-kubernetes/operations/kubernetes-cluster/kubernetes-cluster-create){% endif %} новый.
 
     {% note warning %}
 
@@ -15,7 +15,7 @@
     {% endnote %}
 
 1. Установите {{ k8s }} CLI [kubectl](https://kubernetes.io/docs/tasks/tools/install-kubectl).
-1. [Настройте](https://cloud.yandex.ru/docs/managed-kubernetes/operations/kubernetes-cluster/kubernetes-cluster-get-credetials) конфигурацию kubectl.
+1. [Настройте]{% if lang == "en" %}(https://cloud.yandex.com/en/docs/managed-kubernetes/operations/kubernetes-cluster/kubernetes-cluster-get-credetials){% endif %}{% if lang == "ru" %}(https://cloud.yandex.ru/docs/managed-kubernetes/operations/kubernetes-cluster/kubernetes-cluster-get-credetials){% endif %} конфигурацию kubectl.
 1. Установите менеджер пакетов {{ k8s }} [Нelm 3](https://helm.sh/docs/intro/install/).
 1. Добавьте в Helm репозиторий для {{ yandex-cloud }}:
 
diff --git a/ydb/docs/ru/core/faq/_includes/serverless.md b/ydb/docs/ru/core/faq/_includes/serverless.md
index e4ef227991d..1d301993ad8 100644
--- a/ydb/docs/ru/core/faq/_includes/serverless.md
+++ b/ydb/docs/ru/core/faq/_includes/serverless.md
@@ -2,7 +2,7 @@
 
 #### Как вторичные индексы влияют на стоимость запроса?
 
-Операции с индексами оцениваются по тем же правилам, что и операции с таблицами. Они отражаются в статистике исполнения запроса и включаются в суммарные показатели, на основании которых делается расчет стоимости в RequestUnits (RU). Подробнее читайте в [правилах тарификации бессерверного режима для {{ ydb-short-name }} API](https://cloud.yandex.ru/docs/ydb/pricing/request_units_yql).
+Операции с индексами оцениваются по тем же правилам, что и операции с таблицами. Они отражаются в статистике исполнения запроса и включаются в суммарные показатели, на основании которых делается расчет стоимости в RequestUnits (RU). Подробнее читайте в [правилах тарификации бессерверного режима для {{ ydb-short-name }} API]{% if lang == "en" %}(https://cloud.yandex.com/en/docs/ydb/pricing/request_units_yql){% endif %}{% if lang == "ru" %}(https://cloud.yandex.ru/docs/ydb/pricing/request_units_yql){% endif %}.
 
 При чтении данных из таблицы с использованием индекса в статистике исполнения запроса будет видно количество считанных из индекса записей и их объем.
 
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 2f498e4a960..6b6109df9e8 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
@@ -2,7 +2,7 @@
 
 Сборка документации осуществляется утилитой [YFM-Docs](https://github.com/yandex-cloud/yfm-docs).
 
-Порядок установки YFM-Docs описан на [вводной странице документации по этой утилите](https://ydocs.tech/ru/tools/docs/).
+Порядок установки YFM-Docs описан на [вводной странице документации по этой утилите]{% if lang == "en" %}(https://ydocs.tech/en/tools/docs/){% endif %}{% if lang == "ru" %}(https://ydocs.tech/ru/tools/docs/){% endif %}.
 
 Для сборки OpenSource документации {{ ydb-short-name }} нужно выполнить команду:
 
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 1596da96f75..88a63c0d98b 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-short-name }}.
+Исходный код документации создается в формате [Markdown]{% if lang == "en" %}(https://en.wikipedia.org/wiki/Markdown){% endif %}{% if lang == "ru" %}(https://ru.wikipedia.org/wiki/Markdown){% endif %}, с расширениями [YFM (Yandex Flavoured Markdown)]{% if lang == "en" %}(https://ydocs.tech/en/){% endif %}{% if lang == "ru" %}(https://ydocs.tech/ru/){% endif %}. Эффективным способом быстро изучить эти форматы является знакомство с исходным кодом имеющейся документации {{ ydb-short-name }}.
 
 Кроме описанных здесь формальных правил, всегда действует неявное дополнение: если на какую-то тему правило формально не описано, необходимо посмотреть как уже сделано ранее в других местах документации, и сделать по аналогии.
 
@@ -281,8 +281,8 @@ Github репозиторий {{ ydb-short-name }}: [https://github.com/ydb-plat
 Указываемый в квадратных скобках текст показывается в браузере пока не загружена сама картинка. Он может повторять имя файла из ссылки без расширения. 
 
 Желательные форматы для изображений:
-- Диаграммы: [.SVG](https://ru.wikipedia.org/wiki/SVG)
-- Скриншоты: [.PNG](https://ru.wikipedia.org/wiki/PNG)
+- Диаграммы: [.SVG]{% if lang == "en" %}(https://en.wikipedia.org/wiki/Scalable_Vector_Graphics){% endif %}{% if lang == "ru" %}(https://ru.wikipedia.org/wiki/SVG){% endif %}
+- Скриншоты: [.PNG]{% if lang == "en" %}(https://en.wikipedia.org/wiki/Portable_Network_Graphics){% endif %}{% if lang == "ru" %}(https://ru.wikipedia.org/wiki/PNG){% endif %}
 
 Так как картинка является частью какой-то статьи, то размещение картинки без статьи невозможно. Если текста статьи пока нет, то необходимо определить тематический каталог размещения и имя файла будущей статьи, в тексте указать только ссылку на картинку (не забыть про то что [текст статьи размещается в подкаталоге `_includes`](#articles)!), и не включать саму статью в TOC до тех пор, пока он не будет готова к публикации.
 
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 53431af5ea7..10f02511ddf 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
@@ -4,6 +4,6 @@
 
 * через опции командной строки `--access-key` и `--secret-key`;
 * через переменные окружения `AWS_ACCESS_KEY_ID` и `AWS_SECRET_ACCESS_KEY`;
-* через файл `~/.aws/credentials`, создаваемый и используемый [AWS CLI](https://aws.amazon.com/ru/cli/).
+* через файл `~/.aws/credentials`, создаваемый и используемый [AWS CLI]{% if lang == "en" %}(https://aws.amazon.com/cli/){% endif %}{% if lang == "ru" %}(https://aws.amazon.com/ru/cli/){% endif %}.
 
 Настройки применяются в порядке, описанном выше. Например, если одновременно использовать все три варианта передачи значения access_key или secret_key, то будут использованы значения, переданные через опции командной строки.
diff --git a/ydb/docs/ru/core/reference/ydb-sdk/example/_includes/steps/06_param_queries.md b/ydb/docs/ru/core/reference/ydb-sdk/example/_includes/steps/06_param_queries.md
index 2886452e366..9b33ed99753 100644
--- a/ydb/docs/ru/core/reference/ydb-sdk/example/_includes/steps/06_param_queries.md
+++ b/ydb/docs/ru/core/reference/ydb-sdk/example/_includes/steps/06_param_queries.md
@@ -1,3 +1,3 @@
 ## Параметризованные запросы {#param-queries}
 
-Выполняется запрос к данным с использованием параметров. Этот вариант выполнения запросов является предпочтительным, так как позволяет серверу переиспользовать план исполнения запроса при последующих его вызовах, а также спасает от уязвимостей вида [SQL Injection](https://ru.wikipedia.org/wiki/Внедрение_SQL-кода).
+Выполняется запрос к данным с использованием параметров. Этот вариант выполнения запросов является предпочтительным, так как позволяет серверу переиспользовать план исполнения запроса при последующих его вызовах, а также спасает от уязвимостей вида [SQL Injection]{% if lang == "en" %}(https://en.wikipedia.org/wiki/SQL_injection){% endif %}{% if lang == "ru" %}(https://ru.wikipedia.org/wiki/Внедрение_SQL-кода){% endif %}.
diff --git a/ydb/docs/ru/core/troubleshooting/_includes/monitoring_sensors.md b/ydb/docs/ru/core/troubleshooting/_includes/monitoring_sensors.md
index 4142db3bcf9..b28e0e1ea9b 100644
--- a/ydb/docs/ru/core/troubleshooting/_includes/monitoring_sensors.md
+++ b/ydb/docs/ru/core/troubleshooting/_includes/monitoring_sensors.md
@@ -4,7 +4,7 @@
 
 Имя метрики<br/>Тип, единицы измерения | Описание<br/>Метки
 ----- | -----
-`resources.storage.used_bytes`<br/>`IGAUGE`, байты  | Размер пользовательских и служебных данных, сохраненных в распределенном сетевом хранилище. К служебным данным относятся данные первичного и [вторичных индексов](https://cloud.yandex.ru/docs/ydb/oss/public/develop/concepts/secondary_indexes).
+`resources.storage.used_bytes`<br/>`IGAUGE`, байты  | Размер пользовательских и служебных данных, сохраненных в распределенном сетевом хранилище. К служебным данным относятся данные первичного и [вторичных индексов](../../concepts/secondary_indexes.md).
 `resources.storage.limit_bytes`<br/>`IGAUGE`, байты  | Ограничение на размер пользовательских и служебных данных, которые база данных может сохранить в распределенном сетевом хранилище.
 
 ### Метрики API {#api}
@@ -16,9 +16,9 @@
 `api.grpc.request.inflight_count`<br/>`IGAUGE`, штуки | Количество запросов, которые одновременно обрабатываются базой данных в определенный период времени.<br/>Метки:<br/>- _api_service_ – название сервиса gRPC API, например `table`.<br/>- _method_ – название метода сервиса gRPC API, например `ExecuteDataQuery`.
 `api.grpc.request.inflight_bytes`<br/>`IGAUGE`, байты | Размер запросов, которые одновременно обрабатываются базой данных в определенный период времени.<br/>Метки:<br/>- _api_service_ – название сервиса gRPC API, например `table`.<br/>- _method_ – название метода сервиса gRPC API, например `ExecuteDataQuery`.
 `api.grpc.response.bytes`<br/>`RATE`, байты | Размер ответов, которые отправлены базой данный в определенный период времени.<br/>Метки:<br/>- _api_service_ – название сервиса gRPC API, например `table`.<br/>- _method_ – название метода сервиса gRPC API, например `ExecuteDataQuery`.
-`api.grpc.response.count`<br/>`RATE`, штуки | Количество ответов, которые отправлены базой в определенный период времени.<br/>Метки:<br/>- _api_service_ – название сервиса gRPC API, например `table`.<br/>- _method_ – название метода сервиса gRPC API, например `ExecuteDataQuery`.<br/>- _status_ – статус выполнения запроса, подробнее статусы описаны в разделе [Обработка ошибок](https://cloud.yandex.ru/docs/ydb/oss/public/reference/ydb-sdk/error_handling).
+`api.grpc.response.count`<br/>`RATE`, штуки | Количество ответов, которые отправлены базой в определенный период времени.<br/>Метки:<br/>- _api_service_ – название сервиса gRPC API, например `table`.<br/>- _method_ – название метода сервиса gRPC API, например `ExecuteDataQuery`.<br/>- _status_ – статус выполнения запроса, подробнее статусы описаны в разделе [Обработка ошибок](../../reference/ydb-sdk/error_handling.md).
 `api.grpc.response.dropped_count`<br/>`RATE`, штуки | Количество ответов, отправка которых была прекращена на на транспортном (gRPC) уровне из-за ошибки.<br/>Метки:<br/>- _api_service_ – название сервиса gRPC API, например `table`.<br/>- _method_ – название метода сервиса gRPC API, например `ExecuteDataQuery`.
-`api.grpc.response.issues`<br/>`RATE`, штуки | Количество ошибок определенного типа, возникших при выполнении запросов в определенный период времени.<br/>Метки:<br/>- _issue_type_ – тип ошибки, единственное значение – `optimistic_locks_invalidation`, подробнее инвалидация блокировок описана в разделе [Транзакции и запросы к {{ ydb-short-name }}](https://cloud.yandex.ru/docs/ydb/oss/public/develop/concepts/transactions).
+`api.grpc.response.issues`<br/>`RATE`, штуки | Количество ошибок определенного типа, возникших при выполнении запросов в определенный период времени.<br/>Метки:<br/>- _issue_type_ – тип ошибки, единственное значение – `optimistic_locks_invalidation`, подробнее инвалидация блокировок описана в разделе [Транзакции и запросы к {{ ydb-short-name }}](../../concepts/transactions.md).
 
 ### Метрики сессий {#sessions}
 
diff --git a/ydb/docs/ru/core/yql/reference/yql-docs-core-2/syntax/_includes/join.md b/ydb/docs/ru/core/yql/reference/yql-docs-core-2/syntax/_includes/join.md
index 73bf7c62ae1..11210b88898 100644
--- a/ydb/docs/ru/core/yql/reference/yql-docs-core-2/syntax/_includes/join.md
+++ b/ydb/docs/ru/core/yql/reference/yql-docs-core-2/syntax/_includes/join.md
@@ -80,7 +80,7 @@ LEFT  JOIN c_table AS c ON c.ref = a.key and c.column1 = b.value;
 Если в выражении помимо `JOIN` выполняется фильтрация данных, то рекомендуется обернуть те условия, про которые известно, что они вернут `true` для большинства строк, в вызов функции `LIKELY(...)`. Если предположение о преобладании положительных значений в условии окажется верно, такая подсказка может положительно сказаться на времени выполнения запроса. Также `LIKELY` может быть полезен в том случае, когда вычисление предиката ресурсоёмко и при этом сам JOIN значительно сокращает число строк.
 
 Перед любым источником данных для `JOIN` можно указать ключевое слово `ANY`, которое служит для подавления дубликатов по ключам `JOIN` с соответствующей стороны. В этом случае из множества строк с одинаковым значением ключей `JOIN` остается только одна (не уточняется какая именно – отсюда и название `ANY`).
-Данный синтаксис отличается от принятого в [ClickHouse](https://clickhouse.tech/docs/ru/sql-reference/statements/select/join/), где `ANY` пишется перед типом `JOIN` и работает только для правой стороны.
+Данный синтаксис отличается от принятого в [ClickHouse]{% if lang == "en" %}(https://clickhouse.com/docs/en/sql-reference/statements/select/join/){% endif %}{% if lang == "ru" %}(https://clickhouse.tech/docs/ru/sql-reference/statements/select/join/){% endif %}, где `ANY` пишется перед типом `JOIN` и работает только для правой стороны.
 
 Запрос