docs(handbook): упрощен язык путеводителя
Зачем: начинающим ученикам трудно читать главы без пояснений терминов и ожидаемого результата примеров. Что: уточнены заголовки и объяснения в пяти главах и вводной, добавлена сверка графика с SQL, обновлены ссылки из заданий и документации генератора. Проверка: SQL и команды сохранены, локальные ссылки проверены; git diff --check пройден. Ревью смысла Sol 6.1 high замечаний не выявило, новые пояснения дополнительно сверены с кодом и настройками.
This commit is contained in:
1 parent
9394b789e5
commit
453a1d6ddf
13 files changed
+98
-75
No files matched your search
+12
-10
@@ -4,9 +4,11 @@
|
||||
и попадают в отчеты. В главах есть короткие примеры, которые можно выполнить
|
||||
на запущенном стенде перед переходом к учебным заданиям.
|
||||
|
||||
## Как читать
|
||||
## Порядок чтения
|
||||
|
||||
Читайте главы в порядке ниже. Незнакомые термины можно найти в
|
||||
Сначала запустите стенд по [инструкции](../../README.md#быстрый-старт).
|
||||
Затем читайте главы по порядку и выполняйте примеры из них.
|
||||
Незнакомые термины можно найти в
|
||||
[словаре понятий](../../CONTEXT.md), а подробности устройства —
|
||||
в [технических справочниках](../architecture/). К ним достаточно обращаться
|
||||
по мере необходимости. После путеводителя переходите к
|
||||
@@ -19,27 +21,27 @@ Gitea показывает HTML как текст. Откройте файл и
|
||||
или скачайте его кнопкой «Raw» и откройте в браузере.
|
||||
Сверяйтесь с картой при чтении главы «Хранилище и его слои».
|
||||
|
||||
## Главы
|
||||
## Содержание
|
||||
|
||||
### [Хранилище и его слои](storage-layers.md)
|
||||
|
||||
Как меняются данные при переходе из Kafka в слои STG, ODS, DDS и DM.
|
||||
В конце главы вы посмотрите события, сессии и выручку с помощью SQL.
|
||||
|
||||
### [Потоки Airflow и даги модельного времени](airflow-dags.md)
|
||||
### [Генерация и обработка данных в Airflow](airflow-dags.md)
|
||||
|
||||
Какие даги создают новые данные, а какие обрабатывают их в хранилище.
|
||||
Вы запустите генерацию и обработку за день и посмотрите результат в витринах.
|
||||
Вы сравните содержимое витрин до и после обработки нового дня.
|
||||
|
||||
### [Мониторинг: куда смотреть](monitoring.md)
|
||||
### [Мониторинг в Grafana](monitoring.md)
|
||||
|
||||
Что показывают панели Grafana и как меняются их показания, пока в стенд
|
||||
поступают события и заказы.
|
||||
поступают события и заказы. Вы увидите, почему заказы обновляются реже событий.
|
||||
|
||||
### [Немного Superset](superset.md)
|
||||
### [Отчеты в Superset](superset.md)
|
||||
|
||||
Как Superset строит графики по витринам и что происходит с вашими отчетами
|
||||
при перезапуске стенда.
|
||||
Как Superset строит графики по витринам. Вы сравните числа на готовом графике
|
||||
с результатом SQL и узнаете, какие отчеты сохраняются при перезапуске стенда.
|
||||
|
||||
### [Генератор: откуда берутся данные](generator.md)
|
||||
|
||||
|
||||
Reference in new issue
Block a user