From 0bde52cd4c144f5224391bc043667fcc3749b827 Mon Sep 17 00:00:00 2001
From: "a.tolstoy" <a.tolstoy@picodata.io>
Date: Mon, 13 Nov 2023 14:52:06 +0300
Subject: [PATCH] large url renaming

---
 docs/architecture/clustering.md               |  2 +-
 docs/architecture/discovery.md                |  2 +-
 ...{broadcasted_sql.md => distributed_sql.md} | 14 +++---
 docs/architecture/raft_failover.md            |  2 +-
 docs/index.md                                 | 44 +++++++++----------
 docs/{general => overview}/benefits.md        |  2 +-
 docs/{general => overview}/description.md     | 18 ++++----
 docs/{general => overview}/feedback.md        |  2 +-
 docs/{general => overview}/glossary.md        |  2 +-
 .../reference.md => reference/ansi_sql.md}    |  4 +-
 docs/{references => reference}/api.md         | 26 +++++------
 docs/{references => reference}/cli.md         |  4 +-
 .../queries.md => reference/sql_queries.md}   | 22 +++++-----
 .../datatypes.md => reference/sql_types.md}   |  4 +-
 .../connecting.md}                            | 17 ++++---
 .../deploy_on_hosts.md => tutorial/deploy.md} |  8 ++--
 docs/{tutorials => tutorial}/install.md       |  6 +--
 .../auth_ldap.md => tutorial/ldap.md}         |  4 +-
 docs/{tutorials => tutorial}/monitoring.md    |  6 +--
 .../sql_examples.md}                          | 22 +++++-----
 .../{tutorials => tutorial}/tutorial_users.md | 20 ++++-----
 .../tutorial_webui.md => tutorial/webui.md}   | 12 ++---
 mkdocs.yml                                    | 36 +++++++--------
 23 files changed, 139 insertions(+), 140 deletions(-)
 rename docs/architecture/{broadcasted_sql.md => distributed_sql.md} (91%)
 rename docs/{general => overview}/benefits.md (98%)
 rename docs/{general => overview}/description.md (62%)
 rename docs/{general => overview}/feedback.md (92%)
 rename docs/{general => overview}/glossary.md (99%)
 rename docs/{references/reference.md => reference/ansi_sql.md} (98%)
 rename docs/{references => reference}/api.md (97%)
 rename docs/{references => reference}/cli.md (99%)
 rename docs/{references/queries.md => reference/sql_queries.md} (98%)
 rename docs/{references/datatypes.md => reference/sql_types.md} (94%)
 rename docs/{tutorials/tutorial_first_steps.md => tutorial/connecting.md} (87%)
 rename docs/{tutorials/deploy_on_hosts.md => tutorial/deploy.md} (98%)
 rename docs/{tutorials => tutorial}/install.md (98%)
 rename docs/{tutorials/auth_ldap.md => tutorial/ldap.md} (98%)
 rename docs/{tutorials => tutorial}/monitoring.md (95%)
 rename docs/{tutorials/tutorial_data.md => tutorial/sql_examples.md} (83%)
 rename docs/{tutorials => tutorial}/tutorial_users.md (88%)
 rename docs/{tutorials/tutorial_webui.md => tutorial/webui.md} (88%)

diff --git a/docs/architecture/clustering.md b/docs/architecture/clustering.md
index c8554388..48c8dd97 100644
--- a/docs/architecture/clustering.md
+++ b/docs/architecture/clustering.md
@@ -134,7 +134,7 @@ discovery не будет, инстанс сразу перейдет к эта
 
 Для первичного вызова `box.cfg()`:
 - идентификаторы  `instance_uuid`, `replicaset_uuid`,
-- `box.cfg.replication` — список [адресов](../general/glossary.md#address) для репликации.
+- `box.cfg.replication` — список [адресов](../overview/glossary.md#address) для репликации.
 
 Получив все настройки, инстанс использует их в `box.cfg()` (см.
 [`init_common()`](#fn-init_common)), и затем создает в БД группу
diff --git a/docs/architecture/discovery.md b/docs/architecture/discovery.md
index 1320842a..88cbf9a4 100644
--- a/docs/architecture/discovery.md
+++ b/docs/architecture/discovery.md
@@ -1,6 +1,6 @@
 # Алгоритм discovery
 В данном разделе описаны подробности работы алгоритма
-[discovery](../general/glossary.md#discovery), который отвечает за обнаружение
+[discovery](../overview/glossary.md#discovery), который отвечает за обнаружение
 инстансами друг друга при инициализации кластера.
 
 ## Входные данные {: #initial-state }
diff --git a/docs/architecture/broadcasted_sql.md b/docs/architecture/distributed_sql.md
similarity index 91%
rename from docs/architecture/broadcasted_sql.md
rename to docs/architecture/distributed_sql.md
index 587564e0..ba569d13 100644
--- a/docs/architecture/broadcasted_sql.md
+++ b/docs/architecture/distributed_sql.md
@@ -4,7 +4,7 @@ Picodata включает в себя богатую функционально
 
 ## Принципы работы {: #sql-essentials }
 
-Принципы работы распределенного SQL согласуются с требованиями [стандарта SQL](../references/reference) (_Structured Query Language_, язык структурированных запросов) для хранения и управления данными в виде таблиц:
+Принципы работы распределенного SQL согласуются с требованиями [стандарта SQL](../reference/ansi_sql) (_Structured Query Language_, язык структурированных запросов) для хранения и управления данными в виде таблиц:
 
 * Любая таблица представляет собой именованный набор строк;
 * Все строки таблицы имеют одинаковый набор именованных столбцов;
@@ -36,14 +36,14 @@ style="color:#39cb00ff">_зеленым_</span> — собранные фраг
 ### Распределение данных {: #data-distribution }
 Распределенный SQL требует собственно распределения данных между
 различными репликасетами (шардами) кластера. Это достигается за счет
-использования встроенной библиотеки [Vshard](../general/glossary.md#vshard).
+использования встроенной библиотеки [Vshard](../overview/glossary.md#vshard).
 Взаимодействие Picodata SQL и Vshard заключается в разделении функций:
 
-- Picodata SQL работает с шардированными [таблицами](../general/glossary.md#table)
+- Picodata SQL работает с шардированными [таблицами](../overview/glossary.md#table)
   (таблицами), отдельные строки (кортежи) которых распределяются по
-  разным [бакетам](../general/glossary.md#bucket);
+  разным [бакетам](../overview/glossary.md#bucket);
 - Vshard работает с распределением бакетов по
-  [репликасетам](../general/glossary.md#replicaset).
+  [репликасетам](../overview/glossary.md#replicaset).
 
 У каждой распределенной таблицы в схеме данных всегда есть два признака:
 
@@ -65,7 +65,7 @@ Picodata SQL включает внутреннюю функцию по вычи
 `sharding_key`, попадут в один бакет.
 
 Описание поддерживаемых запросов и их синтаксиса приведены в разделе:
-[Команды SQL](../references/queries.md)
+[Команды SQL](../reference/sql_queries.md)
 
 ---
-[Исходный код страницы](https://git.picodata.io/picodata/picodata/docs/-/blob/main/docs/architecture/broadcasted_sql.md)
+[Исходный код страницы](https://git.picodata.io/picodata/picodata/docs/-/blob/main/docs/architecture/distributed_sql.md)
diff --git a/docs/architecture/raft_failover.md b/docs/architecture/raft_failover.md
index 02c25c9c..dcf2f96c 100644
--- a/docs/architecture/raft_failover.md
+++ b/docs/architecture/raft_failover.md
@@ -61,7 +61,7 @@ Raft предполагает, что в кластере всегда суще
 
 См. также:
 
-- [Репликация и зоны доступности](../tutorials/deploy_on_hosts.md#failure-domains)
+- [Репликация и зоны доступности](../tutorial/deploy.md#failure-domains)
 
 ---
 [Исходный код страницы](https://git.picodata.io/picodata/picodata/docs/-/blob/main/docs/architecture/raft_failover.md)
diff --git a/docs/index.md b/docs/index.md
index df5fe47c..89f9c6dd 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -10,31 +10,31 @@ Picodata — это распределенная система промышле
 На этом портале представлена документация по Picodata:
 
 
-### Ознакомление с ПО Picodata {: #getting-started }
-* [Общее описание продукта](general/description)
-* [Преимущества использования Picodata](general/benefits)
-* [Глоссарий](general/glossary)
-* [Обратная связь и получение помощи](general/feedback)
+### Ознакомление с ПО Picodata {: #overview }
+* [Общее описание продукта](overview/description)
+* [Преимущества использования Picodata](overview/benefits)
+* [Глоссарий](overview/glossary)
+* [Обратная связь и получение помощи](overview/feedback)
 
-### Инструкции и руководства {: #manuals-and-howtos }
-* [Установка Picodata](tutorials/install)
-* [Запуск кластера](tutorials/deploy_on_hosts)
-* [Мониторинг кластера](tutorials/monitoring)
-* [Подключение и работа в консоли](tutorials/tutorial_first_steps)
-* [Работа в веб-интерфейсе](tutorials/tutorial_webui)
-* [Авторизация с помощью LDAP](tutorials/auth_ldap)
-* [Пользователи, привилегии и роли](tutorials/tutorial_users)
-* [Работа с данными SQL](tutorials/tutorial_data)
+### Инструкции и руководства {: #tutorial }
+* [Установка Picodata](tutorial/install)
+* [Запуск кластера](tutorial/deploy)
+* [Мониторинг кластера](tutorial/monitoring)
+* [Подключение и работа в консоли](tutorial/connecting)
+* [Работа в веб-интерфейсе](tutorial/webui)
+* [Авторизация с помощью LDAP](tutorial/ldap)
+* [Управление доступом](tutorial/tutorial_users)
+* [Работа с данными SQL](tutorial/sql_examples)
 
-### Справочные материалы {: #references }
-* [Аргументы командной строки](references/cli)
-* [Типы данных SQL](references/datatypes)
-* [Команды SQL](references/queries)
-* [Публичный API](references/api)
-* [Совместимость с ANSI SQL](references/reference)
+### Справочные материалы {: #reference }
+* [Аргументы командной строки](reference/cli)
+* [Типы данных SQL](reference/sql_types)
+* [Команды SQL](reference/sql_queries)
+* [Публичный API](reference/api)
+* [Совместимость с ANSI SQL](reference/ansi_sql)
 
-### Архитектура {: #arch }
-* [Распределенный SQL](architecture/broadcasted_sql)
+### Архитектура {: #architecture }
+* [Распределенный SQL](architecture/distributed_sql)
 * [Алгоритм discovery](architecture/discovery)
 * [Raft и отказоустойчивость](architecture/raft_failover)
 * [Жизненный цикл кластера](architecture/clustering)
diff --git a/docs/general/benefits.md b/docs/overview/benefits.md
similarity index 98%
rename from docs/general/benefits.md
rename to docs/overview/benefits.md
index 5f537bfb..f5c68820 100644
--- a/docs/general/benefits.md
+++ b/docs/overview/benefits.md
@@ -32,4 +32,4 @@ Picodata — это не только программное обеспечен
 * Выполнение запросов на изменение настроек кластера.
 
 ---
-[Исходный код страницы](https://git.picodata.io/picodata/picodata/docs/-/blob/main/docs/general/benefits.md)
+[Исходный код страницы](https://git.picodata.io/picodata/picodata/docs/-/blob/main/docs/overview/benefits.md)
diff --git a/docs/general/description.md b/docs/overview/description.md
similarity index 62%
rename from docs/general/description.md
rename to docs/overview/description.md
index cc73c692..b691e01d 100644
--- a/docs/general/description.md
+++ b/docs/overview/description.md
@@ -5,7 +5,7 @@
 Picodata — это распределенная система промышленного уровня для управления базами данных с возможностью расширения функциональности за счет плагинов. Исходный код Picodata [открыт](https://git.picodata.io/picodata/picodata){:target="_blank"}. Программное обеспечение Picodata реализует хранение структурированных и неструктурированных данных, транзакционное управление данными, языки запросов SQL и GraphQL, а также поддержку плагинов на языках Rust и Lua.
 
 ## Назначение {: #purpose }
-Основным назначением продукта Picodata является горизонтально масштабируемое хранение структурированных и неструктурированных данных, управление ими, предоставление среды вычислений внутри кластера, состоящего из [реплицированных](../general/glossary.md#replication) отдельных узлов (*[инстансов](../general/glossary.md#instance)*). Данная комбинация возможностей позволяет эффективно реализовать сценарии управления наиболее востребованными, часто изменяющимися, *горячими* данными. В традиционных корпоративных архитектурах для ускорения и повышения надёжности доступа к данным классических, универсальных СУБД используются кэши и шины данных. Цель развития Picodata: заменить три компонента корпоративной архитектуры — кэш, шина и витрина доступа к данным — единым, высокопроизводительным и строго консистентным решением.
+Основным назначением продукта Picodata является горизонтально масштабируемое хранение структурированных и неструктурированных данных, управление ими, предоставление среды вычислений внутри кластера, состоящего из [реплицированных](../overview/glossary.md#replication) отдельных узлов (*[инстансов](../overview/glossary.md#instance)*). Данная комбинация возможностей позволяет эффективно реализовать сценарии управления наиболее востребованными, часто изменяющимися, *горячими* данными. В традиционных корпоративных архитектурах для ускорения и повышения надёжности доступа к данным классических, универсальных СУБД используются кэши и шины данных. Цель развития Picodata: заменить три компонента корпоративной архитектуры — кэш, шина и витрина доступа к данным — единым, высокопроизводительным и строго консистентным решением.
 
 ## Роль в платформе данных {: #platform }
 С точки зрения использования нашего ПО в составе корпоративной платформы, Picodata предоставляет операционный слой управления данными для решений класса In-memory data grid (IMDG). Это резидентная база данных для очень быстрой обработки среднего по объёму массива данных. Все данные хранятся в оперативной памяти, но при этом они персистентны за счёт периодического обновления снимков БД (snapshots) на диске. Ниже показана условная пирамида управления данными с точки зрения их объёма.
@@ -17,7 +17,7 @@ Picodata занимает верхнюю часть пирамиды, т.к. о
 ## Задачи {: #features }
 Программное обеспечение Picodata решает следующие задачи:
 
-* реализация общего [линеаризованного](../general/glossary.md#linearizability) хранилища конфигурации, схемы данных и топологии кластера, встроенного в распределенную систему управления базами данных;
+* реализация общего [линеаризованного](../overview/glossary.md#linearizability) хранилища конфигурации, схемы данных и топологии кластера, встроенного в распределенную систему управления базами данных;
 * предоставление интерфейса командной строки по управлению топологией кластера;
 * реализация runtime-библиотек по работе с сетью, файловому вводу-выводу, реализация кооперативной многозадачности и управления потоками, работа со встроенной СУБД средствами языка Rust;
 * поддержка языка SQL для работы как с данными отдельного инстанса, так и с данными всего кластера;
@@ -51,7 +51,7 @@ Picodata занимает верхнюю часть пирамиды, т.к. о
 * простая настройка для запуска шардированного кластера. Не требуется много файлов конфигурации;
 * совместимость с любыми инструментами развертывания инстансов (Ansible, Chef, Puppet и др.);
 * обеспечение высокой доступности данных без необходимости в кластере Etcd и дополнительных настройках;
-* автоматическое определение активного инстанса в [репликасетах](../general/glossary.md#replicaset) любого размера;
+* автоматическое определение активного инстанса в [репликасетах](../overview/glossary.md#replicaset) любого размера;
 * единая схема данных во всех репликасетах кластера;
 * возможность обновлять схему данных и менять топологию работающего кластера, например, добавлять новые инстансы. Picodata автоматически управляет версиями схемы;
 * встроенные инструменты для создания и запуска приложений;
@@ -60,9 +60,9 @@ Picodata занимает верхнюю часть пирамиды, т.к. о
 
 ## Архитектура кластера {: #architecture }
 ### Составные части кластера {: #cluster-internals }
-Архитектура кластера Picodata предполагает систему отдельных *[инстансов](../general/glossary.md#instance)* — программных узлов, входящих в состав кластера. Каждый такой узел может выполнять различные роли, например роль хранения данных, роль сервера приложения, или служебную роль координатора кластера.
+Архитектура кластера Picodata предполагает систему отдельных *[инстансов](../overview/glossary.md#instance)* — программных узлов, входящих в состав кластера. Каждый такой узел может выполнять различные роли, например роль хранения данных, роль сервера приложения, или служебную роль координатора кластера.
 Все инстансы работают с единой схемой данных и кодом приложения. Каждый процесс базы данных выполняется на одном процессорном ядре и хранит используемый набор данных в оперативной памяти.
-Любой отдельный инстанс является частью набора реплик, который также называют *[репликасетом](../general/glossary.md#replicaset)*. Репликасет может состоять из одного или нескольких инстансов — дубликатов одного и того же набора данных. Внутри репликасета всегда есть *активный* инстанс и — если реплик больше 1 — то некоторое число *резервных* инстансов, обеспечивающих отказоустойчивость системы в случае выхода из строя или недоступности активного инстанса. Число реплик определяется *фактором репликации*, заданным в глобальных настройках Picodata.
+Любой отдельный инстанс является частью набора реплик, который также называют *[репликасетом](../overview/glossary.md#replicaset)*. Репликасет может состоять из одного или нескольких инстансов — дубликатов одного и того же набора данных. Внутри репликасета всегда есть *активный* инстанс и — если реплик больше 1 — то некоторое число *резервных* инстансов, обеспечивающих отказоустойчивость системы в случае выхода из строя или недоступности активного инстанса. Число реплик определяется *фактором репликации*, заданным в глобальных настройках Picodata.
 
 На рисунке ниже показана схема простого кластера из двух репликасетов, каждый из которых состоит из двух инстансов (активного и резервного).
 
@@ -71,21 +71,21 @@ Picodata занимает верхнюю часть пирамиды, т.к. о
 Репликасеты являются единицами горизонтального масштабирования кластера. Данные балансируются между ними автоматически.
 
 ### Хранение данных {: #data-storage }
-Внутри каждого репликасета есть *бакет* ([bucket](../general/glossary.md#bucket)) — виртуализированная неделимая единица хранения, обеспечивающая локальность данных (например, хранение нескольких связанных с клиентом записей на одном физическом узле сети). Сам по себе бакет не имеет ограничений по емкости и может содержать любой объем данных. Горизонтальное масштабирование позволяет распределить бакеты по разным шардам, оптимизируя производительность кластера путем добавления новых реплицированных инстансов. Чем больше репликасетов входит в состав кластера, тем меньше нагрузка на каждый из них. Бакет хранится физически на одном репликасете и является промежуточным звеном между данными и устройством хранения. В каждом репликасете может быть много бакетов (или не быть ни одного). Внутри бакета данные задублированы по всем инстансам в рамках репликасета в соответствии с фактором репликации. Количество бакетов может быть задано при первоначальной настройке кластера. По умолчанию кластер Picodata использует 3000 бакетов.
+Внутри каждого репликасета есть *бакет* ([bucket](../overview/glossary.md#bucket)) — виртуализированная неделимая единица хранения, обеспечивающая локальность данных (например, хранение нескольких связанных с клиентом записей на одном физическом узле сети). Сам по себе бакет не имеет ограничений по емкости и может содержать любой объем данных. Горизонтальное масштабирование позволяет распределить бакеты по разным шардам, оптимизируя производительность кластера путем добавления новых реплицированных инстансов. Чем больше репликасетов входит в состав кластера, тем меньше нагрузка на каждый из них. Бакет хранится физически на одном репликасете и является промежуточным звеном между данными и устройством хранения. В каждом репликасете может быть много бакетов (или не быть ни одного). Внутри бакета данные задублированы по всем инстансам в рамках репликасета в соответствии с фактором репликации. Количество бакетов может быть задано при первоначальной настройке кластера. По умолчанию кластер Picodata использует 3000 бакетов.
 
 Ниже показан пример схемы хранения данных внутри репликасета.
 
 ![Хранение данных](../images/storage.svg)
 
 ### Отказоустойчивость {: #failover }
-Наличие нескольких реплик внутри репликасета обеспечивают его [отказоустойчивость](../general/glossary.md#failsoft). Дополнительно для повышения надежности каждый инстанс кластера внутри репликасета находится на разных физических серверах, а в некоторых случаях — в удаленных друг от друга датацентрах. Таким образом, в случае недоступности датацентра в репликасете происходит переключение на резервную реплику/инстанс без прерывания работы.
+Наличие нескольких реплик внутри репликасета обеспечивают его [отказоустойчивость](../overview/glossary.md#failsoft). Дополнительно для повышения надежности каждый инстанс кластера внутри репликасета находится на разных физических серверах, а в некоторых случаях — в удаленных друг от друга датацентрах. Таким образом, в случае недоступности датацентра в репликасете происходит переключение на резервную реплику/инстанс без прерывания работы.
 
 Пример географического распределения репликасета показан на схеме ниже.
 
 ![Отказоустойчивость](../images/failover.svg)
 
 ### Шардирование {: #sharding }
-[Шардирование](../general/glossary.md#sharding) — это распределение бакетов между различными репликасетами. В Picodata используется основанное на хэшах шардирование с хранением данных в виртуальных бакетах. Каждый репликасет является *шардом*, и чем больше репликасетов имеется в кластере, тем эффективнее данная функция может разделить массив данных на отдельные наборы данных меньшего размера. При добавлении новых инстансов в кластер и/или формировании новых репликасетов Picodata автоматически равномерно распределит бакеты с учетом новой конфигурации.
+[Шардирование](../overview/glossary.md#sharding) — это распределение бакетов между различными репликасетами. В Picodata используется основанное на хэшах шардирование с хранением данных в виртуальных бакетах. Каждый репликасет является *шардом*, и чем больше репликасетов имеется в кластере, тем эффективнее данная функция может разделить массив данных на отдельные наборы данных меньшего размера. При добавлении новых инстансов в кластер и/или формировании новых репликасетов Picodata автоматически равномерно распределит бакеты с учетом новой конфигурации.
 
 Пример автоматического шардирования при добавлении в кластер новых инстансов показан на схеме ниже.
 
@@ -95,4 +95,4 @@ Picodata занимает верхнюю часть пирамиды, т.к. о
 
 
 ---
-[Исходный код страницы](https://git.picodata.io/picodata/picodata/docs/-/blob/main/docs/general/description.md)
+[Исходный код страницы](https://git.picodata.io/picodata/picodata/docs/-/blob/main/docs/overview/description.md)
diff --git a/docs/general/feedback.md b/docs/overview/feedback.md
similarity index 92%
rename from docs/general/feedback.md
rename to docs/overview/feedback.md
index 5ef77924..2522b5cc 100644
--- a/docs/general/feedback.md
+++ b/docs/overview/feedback.md
@@ -10,4 +10,4 @@ Telegram-канале
 [@picodataru](https://t.me/picodataru){:target="_blank"}.
 
 ---
-[Исходный код страницы](https://git.picodata.io/picodata/picodata/docs/-/blob/main/docs/general/feedback.md)
+[Исходный код страницы](https://git.picodata.io/picodata/picodata/docs/-/blob/main/docs/overview/feedback.md)
diff --git a/docs/general/glossary.md b/docs/overview/glossary.md
similarity index 99%
rename from docs/general/glossary.md
rename to docs/overview/glossary.md
index 8ec6fb83..a322ab10 100644
--- a/docs/general/glossary.md
+++ b/docs/overview/glossary.md
@@ -335,4 +335,4 @@ sharding_key:
 **Материализация данных**. Один из этапов исполнения распределенного SQL-запроса, при котором на отдельном узле промежуточные данные сохраняются в его памяти.
 
 ---
-[Исходный код страницы](https://git.picodata.io/picodata/picodata/docs/-/blob/main/docs/general/glossary.md)
+[Исходный код страницы](https://git.picodata.io/picodata/picodata/docs/-/blob/main/docs/overview/glossary.md)
diff --git a/docs/references/reference.md b/docs/reference/ansi_sql.md
similarity index 98%
rename from docs/references/reference.md
rename to docs/reference/ansi_sql.md
index 4e4e3322..57593354 100644
--- a/docs/references/reference.md
+++ b/docs/reference/ansi_sql.md
@@ -96,7 +96,7 @@ Picodata SQL требованиям стандарта SQL:2016, а именно
 ### E071-03. Табличный оператор EXCEPT DISTINCT
 ### F041-03. LEFT OUTER JOIN.
 
-См. также: [Пример работы с SQL Broadcaster в Picodata](../tutorials/tutorial_data.md).
+См. также: [Работа с данными SQL](../tutorial/sql_examples.md).
 
 ---
-[Исходный код страницы](https://git.picodata.io/picodata/picodata/docs/-/blob/main/docs/sql/reference.md)
+[Исходный код страницы](https://git.picodata.io/picodata/picodata/docs/-/blob/main/docs/sql/ansi_sql.md)
diff --git a/docs/references/api.md b/docs/reference/api.md
similarity index 97%
rename from docs/references/api.md
rename to docs/reference/api.md
index b6070c2a..f0cb0e17 100644
--- a/docs/references/api.md
+++ b/docs/reference/api.md
@@ -32,7 +32,7 @@ picodata> pico.help("help")
 | [pico.PICODATA_VERSION](#picopicodata_version) | Версия Picodata.
 | [pico.abort_ddl](#picoabort_ddl) | Отмена ожидающей операции по изменению схемы данных.
 | [pico.args](#picoargs) | Вывод аргументов запуска `picodata run`.
-| [pico.cas()](#picocas) | Запрос на изменение параметров методом [Compare and Swap](../general/glossary.md#as-compare-and-swap).
+| [pico.cas()](#picocas) | Запрос на изменение параметров методом [Compare and Swap](../overview/glossary.md#cas).
 | [pico.change_password()](#picochange_password) | Изменение пароля пользователя.
 | [pico.create_role()](#picocreate_role) | Создание роли.
 | [pico.create_table()](#picocreate_table) | Создание таблицы.
@@ -44,20 +44,20 @@ picodata> pico.help("help")
 | [pico.expel()](#picoexpel) | [Контролируемый вывод](cli.md#expel) инстанса из кластера.
 | [pico.grant_privilege()](#picogrant_privilege) | Назначение привилегии пользователю или роли.
 | [pico.help()](#picohelp) | Доступ к встроенной справочной системе.
-| [pico.instance_info()](#picoinstance_info) | Получение информации об инстансе (идентификаторы, уровни ([grade](../general/glossary.md#grade)) и прочее).
-| [pico.raft_compact_log()](#picoraft_compact_log) | [Компактизация](../general/glossary.md#raft-raft-log-compaction) raft-журнала c удалением указанного числа наиболее старых записей.
+| [pico.instance_info()](#picoinstance_info) | Получение информации об инстансе (идентификаторы, уровни ([grade](../overview/glossary.md#grade)) и прочее).
+| [pico.raft_compact_log()](#picoraft_compact_log) | [Компактизация](../overview/glossary.md#raft-raft-log-compaction) raft-журнала c удалением указанного числа наиболее старых записей.
 | [pico.raft_get_index()](#picoraft_get_index) | Получение текущего примененного индекса raft-журнала.
 | [pico.raft_log()](#picoraft_log) | Чтение содержимого raft-журнала.
 | [pico.raft_propose_nop()](#picoraft_propose_nop) | Добавление в raft-журнал запись `Nop` (no operation).
 | [pico.raft_read_index()](#picoraft_read_index) | Кворумное чтение индекса raft-журнала.
-| [pico.raft_status()](#picoraft_status) | Получение данных о текущем состоянии raft ([терм](../general/glossary.md#term), [лидер](../general/glossary.md#leader) и т.д.).
+| [pico.raft_status()](#picoraft_status) | Получение данных о текущем состоянии raft ([терм](../overview/glossary.md#term), [лидер](../overview/glossary.md#leader) и т.д.).
 | [pico.raft_term()](#picoraft_term) | Получение номера терма (текущего или для указанной записи).
 | [pico.raft_timeout_now()](#picoraft_timeout_now) | Немедленное объявление новых выборов в raft-группе.
 | [pico.raft_wait_index()](#picoraft_wait_index) |  Ожидание локального применения указанного raft-индекса.
 | [pico.revoke_privilege()](#picorevoke_privilege) |  Удаление привилегии у пользователя или роли.
 | [pico.sql()](#picosql) |  Выполнение кластерных SQL-запросов.
 | [pico.wait_ddl_finalize()](#picowait_ddl_finalize) | Ожидание применения (финализации) DDL-операции.
-| [pico.wait_vclock()](#picowait_vclock) | Ожидание момента, когда значение [Vclock](../general/glossary.md#vclock-vector-clock) достигнет целевого.
+| [pico.wait_vclock()](#picowait_vclock) | Ожидание момента, когда значение [Vclock](../overview/glossary.md#vclock-vector-clock) достигнет целевого.
 | [pico.whoami()](#picowhoami) | Отображение данных о текущем инстансе.
 
 
@@ -310,7 +310,7 @@ function create_table(opts)
     - `sharding_fn` (optional _string_), поддерживается пока только функция `murmur3`
     - `engine` (optional _string_), движок хранения данных в БД;
       варианты: `'memtx'` | `'vinyl'`. По умолчанию используется
-      `'memtx'`. См [подробнее](../general/glossary.md#db-engine).
+      `'memtx'`. См [подробнее](../overview/glossary.md#db-engine).
     - `timeout` (optional _number_), число в секундах. По умолчанию
       используется бесконечное значение.
 
@@ -807,7 +807,7 @@ picodata> pico.raft_read_index(1)
 ### pico.raft_status
 
 Получает данные о текущем состоянии raft-узла
-([терм](../general/glossary.md#term), [лидер](../general/glossary.md#leader) и т.д.). Функция
+([терм](../overview/glossary.md#term), [лидер](../overview/glossary.md#leader) и т.д.). Функция
 не имеет передаваемых параметров.
 
 Возвращаемые поля:
@@ -1044,8 +1044,8 @@ pico.sql([[
 ...
 ```
 
-См. также [пример работы с SQL в Picodata](../tutorials/tutorial_data.md) и [описание
-команд SQL](../references/queries.md).
+См. также [пример работы с SQL в Picodata](../tutorial/sql_examples.md) и [описание
+команд SQL](../reference/sql_queries.md).
 
 ### pico.wait_ddl_finalize
 Ожидает применения (финализации) DDL-операции для указанного
@@ -1068,7 +1068,7 @@ function wait_ddl_finalize(index, opts)
 ### pico.wait_vclock
 
 Ожидает момента, когда значение
-[Vclock](../general/glossary.md#vclock-vector-clock) в Tarantool достигнет
+[Vclock](../overview/glossary.md#vclock-vector-clock) в Tarantool достигнет
 целевого.
 
 ```lua
@@ -1182,15 +1182,15 @@ Lua-таблица, описывающая поле в составе табли
 ### table Vclock {: #vclock_table }
 
 Lua-таблица, отражающая соответствие `id` инстанса его
-[LSN-номеру](../general/glossary.md#lsn).
+[LSN-номеру](../overview/glossary.md#lsn).
 
 Пример:
 ```lua
 {[0] = 2, [1] = 101}
 {[0] = 148, [1] = 9086, [3] = 2}
 ```
-См. подробнее описание [Vclock](../general/glossary.md#vclock). Нулевое значение Vclock зарезервировано
+См. подробнее описание [Vclock](../overview/glossary.md#vclock). Нулевое значение Vclock зарезервировано
 для отслеживания локальных изменений, которые не реплицируются.
 
 ---
-[Исходный код страницы](https://git.picodata.io/picodata/picodata/docs/-/blob/main/docs/references/api.md)
+[Исходный код страницы](https://git.picodata.io/picodata/picodata/docs/-/blob/main/docs/reference/api.md)
diff --git a/docs/references/cli.md b/docs/reference/cli.md
similarity index 99%
rename from docs/references/cli.md
rename to docs/reference/cli.md
index 1bd3e419..4071d457 100644
--- a/docs/references/cli.md
+++ b/docs/reference/cli.md
@@ -247,7 +247,7 @@ picodata expel [Параметры]
     — сервер можно выключать.
 
 
-Подробнее об устройстве кластера и репликасетов Picodata см. в разделе [Запуск кластера](../tutorials/deploy_on_hosts.md).
+Подробнее об устройстве кластера и репликасетов Picodata см. в разделе [Запуск кластера](../tutorial/deploy.md).
 
 ---
-[Исходный код страницы](https://git.picodata.io/picodata/picodata/docs/-/blob/main/docs/references/cli.md)
+[Исходный код страницы](https://git.picodata.io/picodata/picodata/docs/-/blob/main/docs/reference/cli.md)
diff --git a/docs/references/queries.md b/docs/reference/sql_queries.md
similarity index 98%
rename from docs/references/queries.md
rename to docs/reference/sql_queries.md
index 3f1b591e..85f48f85 100644
--- a/docs/references/queries.md
+++ b/docs/reference/sql_queries.md
@@ -7,7 +7,7 @@ Picodata при работе с распределенной СУБД.
 
 - Data Definition Language (`DDL`): команды для
   [создания](#create_table) и [удаления](#drop_table)
-  [таблиц](../general/glossary.md#table);
+  [таблиц](../overview/glossary.md#table);
 - Data Modification Language (`DML`): команды [`INSERT`](#insert) для
   добавления данных в таблицы и [`DELETE`](#delete) для удаления данных;
 - Data Query Language (`DQL`): команда [`SELECT`](#select) для получения
@@ -35,8 +35,8 @@ Picodata при работе с распределенной СУБД.
 
 ## Начало работы {: #getting-started }
 Для ввода команд SQL требуется интерактивная консоль Picodata. Она
-доступна после [запуска](../references/cli.md#run-command) инстанса с ключом `-i`
-или явного [подключения](../references/cli.md#connect-command) к нему из отдельного
+доступна после [запуска](../reference/cli.md#run-command) инстанса с ключом `-i`
+или явного [подключения](../reference/cli.md#connect-command) к нему из отдельного
 терминала.
 
 ### Доступные языки консоли {: #available_langs }
@@ -119,7 +119,7 @@ create user andy with password 'P@ssw0rd' using md5 option (timeout = 3.0)
 ```sql
 drop user andy
 ```
-См. [подробнее](../tutorials/tutorial_users.md) об управлении пользователями.
+См. [подробнее](../tutorial/tutorial_users.md) об управлении пользователями.
 
 ## Создание таблицы {: #create_table }
 
@@ -155,7 +155,7 @@ drop user andy
 - _шардированными_, т.е. распределенные по шардам кластера. Для создания
   шардированной таблицы следует использовать параметр `distributed by
   ()`, указав в скобках название колонки, по которой такая таблица будет
-  распределена. См. [подробнее](../general/glossary.md#table).
+  распределена. См. [подробнее](../overview/glossary.md#table).
 
 Для демонстрации работы распределенного SQL будем создавать шардированные таблицы.
 Создадим первую таблицу следующей командой:
@@ -175,7 +175,7 @@ option (timeout = 3.0) ;
 
 При создании таблицы также можно выбрать один из доступных движков хранения данных:
 
-  - `memtx` — [движок хранения данных](../general/glossary.md#db-engine) в ОЗУ (in-memory);
+  - `memtx` — [движок хранения данных](../overview/glossary.md#db-engine) в ОЗУ (in-memory);
   - `vinyl` — дисковый движок хранения данных, использующий LSM-деревья
     (Log Structured Merge Tree).
 
@@ -610,7 +610,7 @@ on "characters"."id" = stock."number" ;
 SELECT-запросах. С ее помощью можно преобразовать числа в текст, дробные
 числа в целые и так далее согласно приведенной [выше](#type) схеме.
 Поддерживаемые в Picodata типы данных приведены в [отдельном
-документе](../datatypes).
+документе](../sql_types).
 
 ### Пример запроса {: #cast-example }
 В качестве примера покажем преобразование дробных чисел в целые с
@@ -756,7 +756,7 @@ insert into "assets" values (1, 'Woody', 2561) ;
 фиксированной запятой (например, `values(2.5)` в `decimal 2.5`). В
 параметризированном виде дробнному числу будет назначен типа с плавающей
 запятой (например, `values(?), {2.5}` в `double 2.5`). См.
-[подробнее](datatypes) о типах данных.
+[подробнее](sql_types) о типах данных.
 
 При использовании `INSERT` вместе с подзапросом (`SELECT`) происходит
 кеширование подзапроса, поэтому его тоже имеет смысл параметризировать,
@@ -1092,7 +1092,7 @@ explain insert into "assets" values (1, 'Woody', 2561) ;
 **Локальная материализация** относится к тем случаям, когда требуется
 положить в память прочитанные данные из локального запроса для их
 дальнейшей обработки. Перемещения данных нет и вычисление `bucket_id` не
-требуется (см. [подробнее](../architecture/broadcasted_sql.md#data-distribution)).
+требуется (см. [подробнее](../architecture/distributed_sql.md#data-distribution)).
 Примером может служить удаление данных из таблицы:
 
 ```sql
@@ -1271,8 +1271,8 @@ explain select count("id") from "characters" ;
 ...
 ```
 
-Читать далее: [Типы данных SQL](datatypes.md)
+Читать далее: [Типы данных SQL](sql_types.md)
 <!-- ebnf source: https://git.picodata.io/picodata/picodata/sbroad/-/blob/main/doc/sql/query.ebnf -->
 
 ---
-[Исходный код страницы](https://git.picodata.io/picodata/picodata/docs/-/blob/main/docs/references/queries.md)
+[Исходный код страницы](https://git.picodata.io/picodata/picodata/docs/-/blob/main/docs/reference/sql_queries.md)
diff --git a/docs/references/datatypes.md b/docs/reference/sql_types.md
similarity index 94%
rename from docs/references/datatypes.md
rename to docs/reference/sql_types.md
index f3203c93..dfc07e51 100644
--- a/docs/references/datatypes.md
+++ b/docs/reference/sql_types.md
@@ -28,7 +28,7 @@
 - `VARCHAR`. Текстовый тип данных с явно заданной длиной строки.
 
 
-См. также: [Совместимость с ANSI SQL](reference.md)
+См. также: [Совместимость с ANSI SQL](ansi_sql.md)
 
 ---
-[Исходный код страницы](https://git.picodata.io/picodata/picodata/docs/-/blob/main/docs/references/datatypes.md)
+[Исходный код страницы](https://git.picodata.io/picodata/picodata/docs/-/blob/main/docs/reference/sql_types.md)
diff --git a/docs/tutorials/tutorial_first_steps.md b/docs/tutorial/connecting.md
similarity index 87%
rename from docs/tutorials/tutorial_first_steps.md
rename to docs/tutorial/connecting.md
index 0d38e00c..787c2e21 100644
--- a/docs/tutorials/tutorial_first_steps.md
+++ b/docs/tutorial/connecting.md
@@ -13,8 +13,7 @@
 администратора СУБД (`admin`) и разрешает все действия в рамках
 локальной консоли. При этом, привилегия `SESSION`, позволяющая
 подключаться к удаленным инстансам по сети, у локального администратора
-отсутствует. Подробнее см. в разделе [Пользователи, привилегии и
-роли](tutorial_users.md).
+отсутствует. Подробнее см. в разделе [Управление доступом](tutorial_users.md).
 
 ## Подключение к ранее запущенному экземпляру {: #accessing-running-instace }
 ### Подключение с помощью адреса экземпляра {: #picodata-connect }
@@ -22,7 +21,7 @@
 ```
 picodata connect localhost:3301
 ```
-По умолчанию, [подключение](../references/cli.md#connect-command) производится под
+По умолчанию, [подключение](../reference/cli.md#connect-command) производится под
 пользователем `guest` без пароля. У такого пользователя имеется
 единственная привилегия
 [`SESSION`](tutorial_users.md#available-privileges).
@@ -58,16 +57,16 @@ picodata connect --unix /tmp/file.socket
 ```
 
 ## Рабочие файлы инстанса
-В [директории с данными инстанса](../references/cli.md#data-dir) автоматически появляются следующие файлы:
+В [директории с данными инстанса](../reference/cli.md#data-dir) автоматически появляются следующие файлы:
 
-- `*.snap` — файлы [снапшотов](../general/glossary.md#snapshot) БД
+- `*.snap` — файлы [снапшотов](../overview/glossary.md#snapshot) БД
 - `*.xlog` — файлы журнала упреждающей записи (Write-ahead log, WAL) c
   инкрементными изменениями БД
 - `*.vylog` — также файлы с инкрементными изменениями БД, но для таблиц,
-  использующих движок хранения [`vinyl`](../general/glossary.md#db-engine).
+  использующих движок хранения [`vinyl`](../overview/glossary.md#db-engine).
 
 При перезапуске инстанса эти файлы необходимы для восстановления его
-состояния, обеспечивая [персистентное](../general/glossary.md#persistence) хранение
+состояния, обеспечивая [персистентное](../overview/glossary.md#persistence) хранение
 данных.
 
 Файлы снапшотов (`*.snap`) и журнала WAL (`*.xlog`/`*.vylog`) не
@@ -77,8 +76,8 @@ picodata connect --unix /tmp/file.socket
 данных нужен будет и последний снапшот, и один или несколько файлов
 журнала.
 
-Параметры запуска из командной строки описаны в разделе [Аргументы командной строки Picodata](../references/cli.md).
+Параметры запуска из командной строки описаны в разделе [Аргументы командной строки](../reference/cli.md).
 
 
 ---
-[Исходный код страницы](https://git.picodata.io/picodata/picodata/docs/-/blob/main/docs/tutorials/tutorial_first_steps.md)
+[Исходный код страницы](https://git.picodata.io/picodata/picodata/docs/-/blob/main/docs/tutorial/connecting.md)
diff --git a/docs/tutorials/deploy_on_hosts.md b/docs/tutorial/deploy.md
similarity index 98%
rename from docs/tutorials/deploy_on_hosts.md
rename to docs/tutorial/deploy.md
index 14e60d20..4728d6c4 100644
--- a/docs/tutorials/deploy_on_hosts.md
+++ b/docs/tutorial/deploy.md
@@ -10,8 +10,8 @@
 Запуск кластера сводится к выполнению команды `picodata run` с нужным
 набором параметров для каждого инстанса (узла). Полный перечень
 возможных параметров запуска и их описание содержатся в разделе
-[Аргументы командной строки Picodata](../../references/cli), а также в выводе команды
-`picodata run --help`. С точки зрения внутренней архитектуры, [_кластер_](../general/glossary.md#cluster)
+[Аргументы командной строки Picodata](../../reference/cli), а также в выводе команды
+`picodata run --help`. С точки зрения внутренней архитектуры, [_кластер_](../overview/glossary.md#cluster)
   корректно называть _raft-группой_ — в дальнейшем при мониторинге и
 управлении конфигурацией будет уместнее использовать именно этот термин.
 
@@ -45,7 +45,7 @@ picodata run --data-dir i3 --listen :3303
 предоставляет доступ к управлению им в консоли. Для подключения к
 интерактивной консоли следует либо запускать инстанс с ключом `-i`
 (`picodata run -i`), либо отдельно подключаться к инстансу командой
-`picodata connect` (см. [подробнее](../references/cli.md#connect-command)).
+`picodata connect` (см. [подробнее](../reference/cli.md#connect-command)).
 
 ## Кластер на нескольких серверах {: #distributed-cluster }
 
@@ -243,4 +243,4 @@ pico.expel("i3")
 См. [отдельный подраздел](../../architecture/raft_failover) с описанием работы алгоритма Raft для обеспечения отказоустойчивости кластера.
 
 ---
-[Исходный код страницы](https://git.picodata.io/picodata/picodata/docs/-/blob/main/docs/tutorials/deploy_on_hosts.md)
+[Исходный код страницы](https://git.picodata.io/picodata/picodata/docs/-/blob/main/docs/tutorial/deploy.md)
diff --git a/docs/tutorials/install.md b/docs/tutorial/install.md
similarity index 98%
rename from docs/tutorials/install.md
rename to docs/tutorial/install.md
index 50dffaa1..657e2844 100644
--- a/docs/tutorials/install.md
+++ b/docs/tutorial/install.md
@@ -213,8 +213,8 @@ picodata run --listen 0.0.0.0:3301 --advertise 192.168.0.1:3301
 Значение параметра `--advertise` анонсируется кластеру при запуске инстанса. Его можно поменять при перезапуске инстанса или в процессе его работы командой `picodata set-advertise`.
 -->
 Подробнее о запуске Picodata и работе с кластером см. в разделе
-[Запуск кластера](../deploy_on_hosts). Параметры запуска из командной
-строки описаны в разделе [Аргументы командной строки Picodata](../../references/cli).
+[Запуск кластера](../deploy). Параметры запуска из командной
+строки описаны в разделе [Аргументы командной строки Picodata](../../reference/cli).
 
 ---
-[Исходный код страницы](https://git.picodata.io/picodata/picodata/docs/-/blob/main/docs/tutorials/install.md)
+[Исходный код страницы](https://git.picodata.io/picodata/picodata/docs/-/blob/main/docs/tutorial/install.md)
diff --git a/docs/tutorials/auth_ldap.md b/docs/tutorial/ldap.md
similarity index 98%
rename from docs/tutorials/auth_ldap.md
rename to docs/tutorial/ldap.md
index b23913c7..3f5804f0 100644
--- a/docs/tutorials/auth_ldap.md
+++ b/docs/tutorial/ldap.md
@@ -70,7 +70,7 @@ pico.change_password('username', '', {auth_type = 'ldap'})
 полученный пароль при взаимодействии с сервером LDAP.
 
 Подробнее о работе с пользователями и привилегиями и см. разделе
-[Публичный API Picodata](../references/api.md).
+[Публичный API Picodata](../reference/api.md).
 
 ### Настройка кластера Picodata {: #cluster-setup }
 
@@ -108,4 +108,4 @@ pico.change_password('username', 'new_password', { auth_type = 'chap-sha1' })
 ```
 
 ---
-[Исходный код страницы](https://git.picodata.io/picodata/picodata/docs/-/blob/main/docs/tutorials/auth_ldap.md)
+[Исходный код страницы](https://git.picodata.io/picodata/picodata/docs/-/blob/main/docs/tutorial/ldap.md)
diff --git a/docs/tutorials/monitoring.md b/docs/tutorial/monitoring.md
similarity index 95%
rename from docs/tutorials/monitoring.md
rename to docs/tutorial/monitoring.md
index 6663427b..b9c4c6f3 100644
--- a/docs/tutorials/monitoring.md
+++ b/docs/tutorial/monitoring.md
@@ -64,7 +64,7 @@ box.space._pico_replicaset:fselect()
 ...
 
 ```
-Таблицы выше позволяют узнать текущий и целевой уровень ([grade](../general/glossary.md#грейд-grade))
+Таблицы выше позволяют узнать текущий и целевой уровень ([grade](../overview/glossary.md#грейд-grade))
 каждого инстанса, а также вес (`weight`) репликасета. Уровни отражают
 конфигурацию остальных инстансов относительно текущего, а вес
 репликасета — его наполненность репликами согласно фактору репликации
@@ -84,7 +84,7 @@ box.space._pico_property:get("current_schema_version")
 увеличению этого номера.
 
 Подробнее о работе с данными в Picodata см. в разделе
-[Работа с данными SQL](../tutorial_data).
+[Работа с данными SQL](../sql_examples).
 
 ---
-[Исходный код страницы](https://git.picodata.io/picodata/picodata/docs/-/blob/main/docs/tutorials/monitoring.md)
+[Исходный код страницы](https://git.picodata.io/picodata/picodata/docs/-/blob/main/docs/tutorial/monitoring.md)
diff --git a/docs/tutorials/tutorial_data.md b/docs/tutorial/sql_examples.md
similarity index 83%
rename from docs/tutorials/tutorial_data.md
rename to docs/tutorial/sql_examples.md
index ff3f9c56..03bf9037 100644
--- a/docs/tutorials/tutorial_data.md
+++ b/docs/tutorial/sql_examples.md
@@ -1,19 +1,19 @@
 # Работа с данными SQL
 В данном разделе приведены примеры команд для работы с данными в
-Picodata с помощью языка [SQL-запросов](../references/queries.md).
+Picodata с помощью языка [SQL-запросов](../reference/sql_queries.md).
 
 ## Создание таблицы {: #creating-table }
 
 Для создания таблицы в Picodata следует сначала
-[подключиться](tutorial_first_steps.md#accessing-console) к
+[подключиться](connecting.md#accessing-console) к
 интерактивной консоли инстанса. Для ввода команд можно использовать
 как формат Lua, так и язык SQL напрямую, в зависимости от
-[выбранного](../references/queries.md#available_langs) языка консоли. В примерах
+[выбранного](../reference/sql_queries.md#available_langs) языка консоли. В примерах
 ниже использован формат Lua.
 
 Пользователям доступны функции для работы как с глобальными, так и
 шардированными таблицами (в последнем случае реализованы возможности
-[распределенного SQL](../architecture/broadcasted_sql.md)).
+[распределенного SQL](../architecture/distributed_sql.md)).
 
 Для примера создадим шаблон списка друзей Свинки Пеппы,
 котором будет два поля: идентификатор записи и имя друга:
@@ -32,7 +32,7 @@ pico.sql([[
 Помимо двух колонок, в примере указаны:
 
 - первичный ключ таблицы (колонка `"id"`);
-- [движок хранения данных](../general/glossary.md#db-engine) in-memory (`memtx`);
+- [движок хранения данных](../overview/glossary.md#db-engine) in-memory (`memtx`);
 - тип таблицы (шардированный, `distributed by`);
 - ключ шардирования таблицы (колонка `"id"`);
 - таймаут перед возвращением управления пользователю.
@@ -51,8 +51,8 @@ pico.sql([[
 ]])
 ```
 
-Подробнее о типах таблиц см. в [глоссарии](../general/glossary.md#table).
-Описание команд SQL приведено в разделе [Команды SQL](../references/queries.md).
+Подробнее о типах таблиц см. в [глоссарии](../overview/glossary.md#table).
+Описание команд SQL приведено в разделе [Команды SQL](../reference/sql_queries.md).
 
 ## Запись данных в таблицу {: #writing-to-table }
 Запись данных, т.е. вставка строк, в таблицу происходит с помощью
@@ -74,7 +74,7 @@ pico.sql(
 	[[insert into "friends_of_peppa" ("id", "name") values (1, "Suzy")]],{}
 )
 ```
-См. [подробнее](../references/queries.md#insert) о различиях в `INSERT`-запросах.
+См. [подробнее](../reference/sql_queries.md#insert) о различиях в `INSERT`-запросах.
 
 ## Чтение данных из таблицы {: #reading-from-table }
 Для чтения всех данных из таблицы подойдёт команда:
@@ -89,7 +89,7 @@ pico.sql([[select * from "friends_of_peppa"]], {})
 pico.sql([[select * from "friends_of_peppa" where "id" = 1]], {})
 ```
 
-См. [подробнее](../references/queries.md#select) о вариантах чтения данных в SQL.
+См. [подробнее](../reference/sql_queries.md#select) о вариантах чтения данных в SQL.
 
 ## Удаление данных {: #deleting-from-table }
 
@@ -105,7 +105,7 @@ picodata> pico.sql([[delete from "friends_of_peppa" where "id" = 1]], {})
 Подробнее о внутренней архитектуре кластера Picodata см. в разделе
 [Жизненный цикл кластера](../architecture/clustering.md).
 
-Параметры запуска из командной строки описаны в разделе [Аргументы командной строки Picodata](../references/cli.md).
+Параметры запуска из командной строки описаны в разделе [Аргументы командной строки Picodata](../reference/cli.md).
 
 ---
-[Исходный код страницы](https://git.picodata.io/picodata/picodata/docs/-/blob/main/docs/tutorials/tutorial_data.md)
+[Исходный код страницы](https://git.picodata.io/picodata/picodata/docs/-/blob/main/docs/tutorial/sql_examples.md)
diff --git a/docs/tutorials/tutorial_users.md b/docs/tutorial/tutorial_users.md
similarity index 88%
rename from docs/tutorials/tutorial_users.md
rename to docs/tutorial/tutorial_users.md
index 48909313..53948a89 100644
--- a/docs/tutorials/tutorial_users.md
+++ b/docs/tutorial/tutorial_users.md
@@ -1,12 +1,12 @@
-# Пользователи, привилегии и роли
-В данном разделе описаны [SQL-команды](../references/queries.md) для управления
+# Управление доступом
+В данном разделе описаны [SQL-команды](../reference/sql_queries.md) для управления
 доступом с помощью ролевой модели в Picodata.
 
 ## Ролевая модель {: #role-model }
 Ролевая модель Picodata позволяет гибко разграничивать возможности
 пользователей распределенной системы. Разграничение строится на базе
-трех основных понятий: [пользователей](../general/glossary.md#user),
-[привилегий](../general/glossary.md#privilege) и [ролей](../general/glossary.md#role).
+трех основных понятий: [пользователей](../overview/glossary.md#user),
+[привилегий](../overview/glossary.md#privilege) и [ролей](../overview/glossary.md#role).
 Привилегии можно назначать напрямую пользователям:
 
 ![Users and privileges](../images/user_priv.svg)
@@ -22,16 +22,16 @@
 
 ## Начало работы {: #getting-started }
 Для начала работы с пользователями, привилегиями и ролями иследует
-[подключиться](tutorial_first_steps.md#accessing-console) к
+[подключиться](connecting.md#accessing-console) к
 интерактивной консоли инстанса Picodata. Для ввода команд можно
 использовать как формат Lua, так и язык SQL напрямую, в зависимости от
-[выбранного](../references/queries.md#available_langs) языка консоли. В примерах
+[выбранного](../reference/sql_queries.md#available_langs) языка консоли. В примерах
 ниже использован язык SQL.
 
 ## Создание пользователя {: #creating-user }
 Создание нового пользователя происходит с помощью SQL-команды `create
 user`, функциональность которой аналогична Lua-функции
-[`pico.create_user()`](../references/api.md#picocreate_user).
+[`pico.create_user()`](../reference/api.md#picocreate_user).
 
 Приведем пример создания нового пользователя:
 
@@ -66,7 +66,7 @@ pico.sql([[
 
 Создание новой роли происходит с помощью SQL-команды `create
 role`, функциональность которой аналогична Lua-функции
-[`pico.create_role()`](../references/api.md#picocreate_role).
+[`pico.create_role()`](../reference/api.md#picocreate_role).
 
 Приведем пример создания новой роли:
 
@@ -150,7 +150,7 @@ pico.sql([[
 ``` -->
 
 
-См. также [`pico.grant_privilege`](../references/api.md#picogrant_privilege) и [`pico.revoke_privilege`](../references/api.md#picorevoke_privilege)
+См. также [`pico.grant_privilege`](../reference/api.md#picogrant_privilege) и [`pico.revoke_privilege`](../reference/api.md#picorevoke_privilege)
 
 ---
-[Исходный код страницы](https://git.picodata.io/picodata/picodata/docs/-/blob/main/docs/tutorials/tutorial_users.md)
+[Исходный код страницы](https://git.picodata.io/picodata/picodata/docs/-/blob/main/docs/tutorial/tutorial_users.md)
diff --git a/docs/tutorials/tutorial_webui.md b/docs/tutorial/webui.md
similarity index 88%
rename from docs/tutorials/tutorial_webui.md
rename to docs/tutorial/webui.md
index 22ac2ccd..30899faf 100644
--- a/docs/tutorials/tutorial_webui.md
+++ b/docs/tutorial/webui.md
@@ -16,13 +16,13 @@ Picodata](install.md).
 
 ## Подключение функции веб-интерфейса
 Веб-интерфейс представляет собой веб-сервер, запускаемый вместе с
-[инстансом](../general/glossary.md#instance) Picodata. Не имеет значения, на каком
+[инстансом](../overview/glossary.md#instance) Picodata. Не имеет значения, на каком
 именно инстансе кластера запущен этот веб-сервер; в любом случае,
 веб-сервер будет отображать данные обо всем кластере.
 
 Для запуска инстанса с веб-сервером следует использовать дополнительный
 параметр `--http-listen` с указанием [хоста и
-порта](../references/cli.md#http-listen)). Пример команды:
+порта](../reference/cli.md#http-listen)). Пример команды:
 
 ```bash
 picodata run --http-listen localhost:8080
@@ -46,7 +46,7 @@ Picodata:
 позволяющее вывести список всех инстансов (узлов) кластера;<br>
 <span style="color:red;font-size:150%">❷</span> — панель основной
 информации о кластере: показателях памяти, количестве
-[репликасетов](../general/glossary.md#replicaset), [инстансов](../general/glossary.md#instance) и их [грейдов](../general/glossary.md#grade), версии
+[репликасетов](../overview/glossary.md#replicaset), [инстансов](../overview/glossary.md#instance) и их [грейдов](../overview/glossary.md#grade), версии
 Picodata;<br>
 <span style="color:red;font-size:150%">❸</span> — кнопка выбора
 группировки представления (по инстансам или репликасетам);<br>
@@ -68,7 +68,7 @@ style="color:red;font-size:150%">❸</span>), то можно сразу уви
 инстансов по имени (нажатие переключает сортировку по
 возрастанию/убыванию);<br>
 <span style="color:blue;font-size:150%">❷</span> — кнопку фильтрации по
-[домену отказа](../general/glossary.md#failure_domain) (позволяет оставить в списке
+[домену отказа](../overview/glossary.md#failure_domain) (позволяет оставить в списке
 только те инстансы, которые удовлетворяют заданному условию);<br>
 <span style="color:blue;font-size:150%">❸</span> — текущий и целевой
 грейды инстанса);<br>
@@ -76,8 +76,8 @@ style="color:red;font-size:150%">❸</span>), то можно сразу уви
 отказа инстанса;<br>
 
 Подробности о запуске кластера Picodata приведены в разделе [Запуск
-кластера](deploy_on_hosts.md).
+кластера](deploy.md).
 
 ---
 [Исходный код
-страницы](https://git.picodata.io/picodata/picodata/docs/-/blob/main/docs/tutorials/tutorial_webui.md)
+страницы](https://git.picodata.io/picodata/picodata/docs/-/blob/main/docs/tutorial/webui.md)
diff --git a/mkdocs.yml b/mkdocs.yml
index 3dcf343e..c875238f 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -5,27 +5,27 @@ repo_url: https://git.picodata.io/picodata/picodata/docs
 
 nav:
   - Ознакомление с ПО Picodata:
-    - general/description.md
-    - general/benefits.md
-    - general/glossary.md
-    - general/feedback.md
+    - overview/description.md
+    - overview/benefits.md
+    - overview/glossary.md
+    - overview/feedback.md
   - Инструкции и руководства:
-    - tutorials/install.md
-    - tutorials/deploy_on_hosts.md
-    - tutorials/monitoring.md
-    - tutorials/tutorial_first_steps.md
-    - tutorials/tutorial_webui.md
-    - tutorials/auth_ldap.md
-    - tutorials/tutorial_users.md
-    - tutorials/tutorial_data.md
+    - tutorial/install.md
+    - tutorial/deploy.md
+    - tutorial/monitoring.md
+    - tutorial/connecting.md
+    - tutorial/webui.md
+    - tutorial/ldap.md
+    - tutorial/tutorial_users.md
+    - tutorial/sql_examples.md
   - Справочные материалы:
-    - references/cli.md
-    - references/datatypes.md
-    - references/queries.md
-    - references/api.md
-    - references/reference.md
+    - reference/cli.md
+    - reference/sql_types.md
+    - reference/sql_queries.md
+    - reference/api.md
+    - reference/ansi_sql.md
   - Архитектура:
-    - architecture/broadcasted_sql.md
+    - architecture/distributed_sql.md
     - architecture/discovery.md
     - architecture/raft_failover.md
     - architecture/clustering.md
-- 
GitLab