yql update, concepts/datatypes removed

yql update, concepts/datatypes removed

ref:fc1d6b7f1a2e3cec2723d2524cc4354ac690e558

18 files changed, 80 insertions, 36 deletions

diff --git a/ydb/docs/ru/core/concepts/datatypes.md b/ydb/docs/ru/core/concepts/datatypes.md
index 3a1725fee9d..e46c8263050 100644
--- a/ydb/docs/ru/core/concepts/datatypes.md
+++ b/ydb/docs/ru/core/concepts/datatypes.md
@@ -1,3 +1 @@
-# Типы данных {{ ydb-name }}
-
-{{ ydb-short-name }} оперирует типами данных YQL.
+Данная страница удалена, информация по типам данных находится в статье [Типы данных YQL](../yql/reference/types/index.md).
\ No newline at end of file
diff --git a/ydb/docs/ru/core/concepts/toc_i.yaml b/ydb/docs/ru/core/concepts/toc_i.yaml
index 9af578b63f8..8b5552a40a1 100644
--- a/ydb/docs/ru/core/concepts/toc_i.yaml
+++ b/ydb/docs/ru/core/concepts/toc_i.yaml
@@ -4,7 +4,7 @@ items:
 - { name: Соединение с БД и аутентификация,       href: connect.md }
 - { name: Модель данных и схема,                  href: datamodel.md }
 - { name: Режимы работы Serverless и Dedicated,   href: serverless_and_dedicated.md }
-- { name: Типы данных,                            href: datatypes.md }
+- { name: Типы данных,                            href: datatypes.md, hidden: true } # Deprecated
 - { name: Транзакции,                             href: transactions.md }
 - { name: Вторичные индексы,                      href: secondary_indexes.md }
 - { name: Time to Live (TTL),                     href: ttl.md }
diff --git a/ydb/docs/ru/core/yql/reference/_includes/index/intro.md b/ydb/docs/ru/core/yql/reference/_includes/index/intro.md
index 778aeca721a..9359975f957 100644
--- a/ydb/docs/ru/core/yql/reference/_includes/index/intro.md
+++ b/ydb/docs/ru/core/yql/reference/_includes/index/intro.md
@@ -7,6 +7,22 @@ keywords:
   - Yandex Query Language
 ---
 
-# Обзор YQL
+# YQL - Обзор
+
+*YQL* (YDB Query Language) — универсальный декларативный язык запросов к YDB, диалект SQL. YQL создавался для работы с большими распределенными базами данных, и поэтому обладает рядом отличий от стандарта SQL.
+
+Инструменты работы с YDB поддерживают интерфейсы отправки YQL-запросов и получения результатов их исполнения:
+
+{% include [yql/ui_prompt.md](yql/ui_prompt.md) %}
+
+- [YDB CLI](../../../../reference/ydb-cli/index.md)
+- [YDB SDK](../../../../reference/ydb-sdk/index.md)
+
+В данном разделе документации находится справочник по YQL, который включает разделы:
+- [Типы данных](../../types/index.md) с описанием типов данных, применяемых в YQL
+- [Синтаксис](../../syntax/index.md) с полным перечнем команд YQL
+- [Встроенные функции](../../builtins/index.md) с описанием доступных встроенных функций
+
+Также вы можете пройти серию уроков, знакомящих вас с основными командами YQL, в разделе
+- [Туториал YQL](../../../tutorial/index.md)
 
-*YQL* (Yandex Query Language) — универсальный декларативный язык запросов к системам хранения и обработки данных, диалект SQL.
diff --git a/ydb/docs/ru/core/yql/reference/_includes/index/start.md b/ydb/docs/ru/core/yql/reference/_includes/index/start.md
index 295f578d593..e69de29bb2d 100644
--- a/ydb/docs/ru/core/yql/reference/_includes/index/start.md
+++ b/ydb/docs/ru/core/yql/reference/_includes/index/start.md
@@ -1,5 +0,0 @@
-Начать работать с YQL можно после создания базы данных. 
-
-В [туториале YQL](../../../tutorial/) приведены примеры YQL-инструкций, с помощью которых можно познакомиться с базовым синтаксисом и возможностями YQL. 
-
-В разделе [{#T}](../../../../operations/crud.md) описаны базовые операции с данными.
diff --git a/ydb/docs/ru/core/yql/reference/_includes/index/yql/ui_prompt.md b/ydb/docs/ru/core/yql/reference/_includes/index/yql/ui_prompt.md
new file mode 100644
index 00000000000..e69de29bb2d
--- /dev/null
+++ b/ydb/docs/ru/core/yql/reference/_includes/index/yql/ui_prompt.md
diff --git a/ydb/docs/ru/core/yql/reference/yql-docs-core-2/builtins/_includes/basic/staticzip.md b/ydb/docs/ru/core/yql/reference/yql-docs-core-2/builtins/_includes/basic/staticzip.md
new file mode 100644
index 00000000000..b6183d56f86
--- /dev/null
+++ b/ydb/docs/ru/core/yql/reference/yql-docs-core-2/builtins/_includes/basic/staticzip.md
@@ -0,0 +1,15 @@
+## StaticZip
+
+Поэлементно "склеивает" структуры или кортежи. Все аргументы (один и более) должны быть либо структурами с одинаковым набором полей, либо кортежами одинаковой длины.
+Результататом будет соответственно структура или кортеж.
+Каждый элемент результата – кортеж с соответствующими элементами из аргументов.
+
+**Примеры:**
+``` yql
+$one = <|k1:1, k2:2.0|>;
+$two = <|k1:3.0, k2:4|>;
+
+-- поэлементное сложение двух структур
+SELECT StaticMap(StaticZip($one, $two), ($tuple)->($tuple.0 + $tuple.1)) AS sum;
+```
+
diff --git a/ydb/docs/ru/core/yql/reference/yql-docs-core-2/builtins/_includes/index.md b/ydb/docs/ru/core/yql/reference/yql-docs-core-2/builtins/_includes/index.md
new file mode 100644
index 00000000000..c966ca6b06a
--- /dev/null
+++ b/ydb/docs/ru/core/yql/reference/yql-docs-core-2/builtins/_includes/index.md
@@ -0,0 +1,16 @@
+# Встроенные функции YQL
+
+- [Базовые](../basic.md)
+- [Агрегатные](../aggregation.md)
+{% if feature_window_functions %}
+- [Оконные](../window.md)
+{% endif %}
+- [Для работы со списками](../list.md)
+- [Для работы со словарями](../dict.md)
+- [Для работы со структурами](../struct.md)
+- [Для работы с типами](../types.md )
+{% if feature_codegen %}
+- [Для работы с генерацией кода](../codegen.md)
+{% endif %}
+- [Для работы с JSON](../json.md)
+- [Библиотеки C++](../../udf/list/index.md)
\ No newline at end of file
diff --git a/ydb/docs/ru/core/yql/reference/yql-docs-core-2/builtins/aggregation.md b/ydb/docs/ru/core/yql/reference/yql-docs-core-2/builtins/aggregation.md
index fd2c0ea7c5d..2d6f0e1f606 100644
--- a/ydb/docs/ru/core/yql/reference/yql-docs-core-2/builtins/aggregation.md
+++ b/ydb/docs/ru/core/yql/reference/yql-docs-core-2/builtins/aggregation.md
@@ -1,29 +1,29 @@
-{% include [x](_includes/aggregation/simple.md) %}
+{% include [simple.md](_includes/aggregation/simple.md) %}
 
-{% include [x](_includes/aggregation/count_distinct_estimate.md) %}
+{% include [count_distinct_estimate.md](_includes/aggregation/count_distinct_estimate.md) %}
 
-{% include [x](_includes/aggregation/agg_list.md) %}
+{% include [agg_list.md](_includes/aggregation/agg_list.md) %}
 
-{% include [x](_includes/aggregation/max_min_by.md) %}
+{% include [max_min_by.md](_includes/aggregation/max_min_by.md) %}
 
-{% include [x](_includes/aggregation/top_bottom.md) %}
+{% include [top_bottom.md](_includes/aggregation/top_bottom.md) %}
 
-{% include [x](_includes/aggregation/topfreq_mode.md) %}
+{% include [topfreq_mode.md](_includes/aggregation/topfreq_mode.md) %}
 
-{% include [x](_includes/aggregation/stddev_variance.md) %}
+{% include [stddev_variance.md](_includes/aggregation/stddev_variance.md) %}
 
-{% include [x](_includes/aggregation/corr_covar.md) %}
+{% include [corr_covar.md](_includes/aggregation/corr_covar.md) %}
 
-{% include [x](_includes/aggregation/percentile_median.md) %}
+{% include [percentile_median.md](_includes/aggregation/percentile_median.md) %}
 
-{% include [x](_includes/aggregation/histogram.md) %}
+{% include [histogram.md](_includes/aggregation/histogram.md) %}
 
-{% include [x](_includes/aggregation/bool_bit.md) %}
+{% include [bool_bit.md](_includes/aggregation/bool_bit.md) %}
 
 {% if feature_window_functions %}
 
-  {% include [x](_includes/aggregation/session_start.md) %}
+  {% include [session_start.md](_includes/aggregation/session_start.md) %}
 
 {% endif %}
 
-{% include [x](_includes/aggregation/aggregate_by.md) %}
+{% include [aggregate_by.md](_includes/aggregation/aggregate_by.md) %}
diff --git a/ydb/docs/ru/core/yql/reference/yql-docs-core-2/builtins/basic.md b/ydb/docs/ru/core/yql/reference/yql-docs-core-2/builtins/basic.md
index 212b8194d0e..b4262430aac 100644
--- a/ydb/docs/ru/core/yql/reference/yql-docs-core-2/builtins/basic.md
+++ b/ydb/docs/ru/core/yql/reference/yql-docs-core-2/builtins/basic.md
@@ -81,10 +81,12 @@
 
 {% include [x](_includes/basic/staticmap.md) %}
 
+{% include [x](_includes/basic/staticzip.md) %}
+
 {% include [x](_includes/basic/aggr_factory.md) %}
 
 {% if tech %}
 
   {% include [x](_includes/basic/s_expressions.md) %}
 
-{% endif %}
\ No newline at end of file
+{% endif %}
diff --git a/ydb/docs/ru/core/yql/reference/yql-docs-core-2/builtins/codegen.md b/ydb/docs/ru/core/yql/reference/yql-docs-core-2/builtins/codegen.md
index 3fb45da7164..bc3bca2b116 100644
--- a/ydb/docs/ru/core/yql/reference/yql-docs-core-2/builtins/codegen.md
+++ b/ydb/docs/ru/core/yql/reference/yql-docs-core-2/builtins/codegen.md
@@ -1,2 +1,2 @@
 
-{% include [x](_includes/codegen.md) %}
+{% include [codegen.md](_includes/codegen.md) %}
diff --git a/ydb/docs/ru/core/yql/reference/yql-docs-core-2/builtins/dict.md b/ydb/docs/ru/core/yql/reference/yql-docs-core-2/builtins/dict.md
index 1d060a286a5..24267d59a41 100644
--- a/ydb/docs/ru/core/yql/reference/yql-docs-core-2/builtins/dict.md
+++ b/ydb/docs/ru/core/yql/reference/yql-docs-core-2/builtins/dict.md
@@ -1,2 +1,2 @@
 
-{% include [x](_includes/dict.md) %}
+{% include [dict.md](_includes/dict.md) %}
diff --git a/ydb/docs/ru/core/yql/reference/yql-docs-core-2/builtins/index.md b/ydb/docs/ru/core/yql/reference/yql-docs-core-2/builtins/index.md
new file mode 100644
index 00000000000..b3cf50bcae9
--- /dev/null
+++ b/ydb/docs/ru/core/yql/reference/yql-docs-core-2/builtins/index.md
@@ -0,0 +1,2 @@
+
+{% include [index.md](_includes/index.md) %}
diff --git a/ydb/docs/ru/core/yql/reference/yql-docs-core-2/builtins/json.md b/ydb/docs/ru/core/yql/reference/yql-docs-core-2/builtins/json.md
index 2a96f5886ec..4b454b1b634 100644
--- a/ydb/docs/ru/core/yql/reference/yql-docs-core-2/builtins/json.md
+++ b/ydb/docs/ru/core/yql/reference/yql-docs-core-2/builtins/json.md
@@ -1,2 +1,2 @@
 
-{% include [x](_includes/json.md) %}
+{% include [json.md](_includes/json.md) %}
diff --git a/ydb/docs/ru/core/yql/reference/yql-docs-core-2/builtins/toc_i.yaml b/ydb/docs/ru/core/yql/reference/yql-docs-core-2/builtins/toc_i.yaml
index 4d98998078e..c9150e8046b 100644
--- a/ydb/docs/ru/core/yql/reference/yql-docs-core-2/builtins/toc_i.yaml
+++ b/ydb/docs/ru/core/yql/reference/yql-docs-core-2/builtins/toc_i.yaml
@@ -1,4 +1,5 @@
 items:
+- { name: Обзор,                        href: index.md }
 - { name: Базовые,                      href: basic.md }
 - { name: Агрегатные,                   href: aggregation.md }
 - { name: Оконные,                      href: window.md,            when: feature_window_functions }
diff --git a/ydb/docs/ru/core/yql/reference/yql-docs-core-2/syntax/_includes/pragma/global.md b/ydb/docs/ru/core/yql/reference/yql-docs-core-2/syntax/_includes/pragma/global.md
index 947aa14aee8..57419fb4b14 100644
--- a/ydb/docs/ru/core/yql/reference/yql-docs-core-2/syntax/_includes/pragma/global.md
+++ b/ydb/docs/ru/core/yql/reference/yql-docs-core-2/syntax/_includes/pragma/global.md
@@ -48,9 +48,9 @@ SELECT * FROM test;`
 
 | Тип значения | По умолчанию |
 | --- | --- |
-| Строка | "disable" |
+| Строка disable/auto/force | "auto" |
 
-При значении "auto" включает новый движок вычислений. Вычисления по возможности делаются без создания map/reduce операций.
+При значении "auto" включает новый движок вычислений. Вычисления по возможности делаются без создания map/reduce операций. При значении "force" вычисление идет в новый движок безусловно.
 {% endif %}
 
 {% if feature_join %}
diff --git a/ydb/docs/ru/core/yql/reference/yql-docs-core-2/syntax/_includes/select/execution.md b/ydb/docs/ru/core/yql/reference/yql-docs-core-2/syntax/_includes/select/execution.md
index 324756fae18..f31e765468c 100644
--- a/ydb/docs/ru/core/yql/reference/yql-docs-core-2/syntax/_includes/select/execution.md
+++ b/ydb/docs/ru/core/yql/reference/yql-docs-core-2/syntax/_includes/select/execution.md
@@ -10,10 +10,10 @@
 * выполняется [WHERE](#where) &mdash; все данные не удовлетворяющие предикату отфильтровываются;
 * выполняется [GROUP BY](../../group_by.md), вычисляются значения агрегатных функций;
 * выполняется фильтрация [HAVING](../../group_by.md#having);
-{% if feature_window_functions %} * ввычисляются значения [оконных функций](../../window.md){% endif %}
-* вычисляются выражения в `SELECT`
+{% if feature_window_functions %} * вычисляются значения [оконных функций](../../window.md);{% endif %}
+* вычисляются выражения в `SELECT`;
 * выражениям в `SELECT` назначаются имена заданные алиасами;
 * к полученным таким образом колонкам применяется top-level [DISTINCT](#distinct);
 * таким же образом вычисляются все подзапросы в [UNION ALL](#unionall), выполняется их объединение (см. [PRAGMA AnsiOrderByLimitInUnionAll](../../pragma.md#pragmas));
 * выполняется сортировка согласно [ORDER BY](#order-by);
-* к полученному результату применяются [OFFSET и LIMIT](#limit-offset).
\ No newline at end of file
+* к полученному результату применяются [OFFSET и LIMIT](#limit-offset).
diff --git a/ydb/docs/ru/core/yql/toc_i.yaml b/ydb/docs/ru/core/yql/toc_i.yaml
index 17ab65dd9f6..d38ee02b48c 100644
--- a/ydb/docs/ru/core/yql/toc_i.yaml
+++ b/ydb/docs/ru/core/yql/toc_i.yaml
@@ -1,7 +1,6 @@
 items:
 - name: Обзор
   href: reference/index.md
-- name: Справочник YQL
-  include: { mode: link, path: reference/toc_i.yaml }
+- include: { mode: link, path: reference/toc_i.yaml }
 - name: Туториал YQL
   include: { mode: link, path: tutorial/toc_i.yaml }
\ No newline at end of file
diff --git a/ydb/docs/ru/core/yql/tutorial/_includes/index/intro.md b/ydb/docs/ru/core/yql/tutorial/_includes/index/intro.md
index 837bf270dc0..ff2cb58bb25 100644
--- a/ydb/docs/ru/core/yql/tutorial/_includes/index/intro.md
+++ b/ydb/docs/ru/core/yql/tutorial/_includes/index/intro.md
@@ -7,7 +7,7 @@ keywords:
   - базовые операции yql
 ---
 
-# Обзор
+# Туториал YQL - Обзор
 
 Из этого туториала вы узнаете, как выполнять базовые операции с данными в {{ ydb-short-name }}, и познакомитесь с синтаксисом YQL.