docs(labs): упрощен язык учебных заданий
Зачем: помочь менти понять действия, проверить результат и оценить освоенное умение. Что: вычитаны 13 заданий основной программы и общий индекс. Итоговые списки обращены к учащемуся, убраны история разработки и повторы. Правила учебного текста записаны в программе, из AGENTS.md добавлена ссылка. Проверка: git diff --check, локальные ссылки и ссылки на измененные заголовки прошли. Блоки кода и таблицы требований совпадают с исходными. Упражнения на стенде повторно не выполнялись: изменен только текст.
This commit is contained in:
1 parent
a03838b953
commit
4058e18864
16 files changed
+287
-269
No files matched your search
@@ -40,6 +40,35 @@
|
||||
- *расследование* — данные уже лежат на стенде или стенд намеренно ломается, а
|
||||
менти ищет причину и объясняет ее.
|
||||
|
||||
### Как писать задания
|
||||
|
||||
Задание обращается к учащемуся на «вы». Начните с «Чему учит»: назовите
|
||||
умение, которое он получит. Затем объясните, для чего нужен результат, и
|
||||
ведите читателя по действиям. Термины раскрывайте там, где без них нельзя
|
||||
понять следующий шаг. Историю разработки оставляйте в рабочих справочниках.
|
||||
|
||||
Раздел «Как проверить себя» описывает способ проверки: что выполнить,
|
||||
с чем сравнить и где искать причину расхождения. Если проверка и есть ход
|
||||
исследования, сохраните ее в шагах, без повторного раздела. В конце задания
|
||||
«Что должно получиться» помогает учащемуся оценить результат: что у него
|
||||
работает, что он проверил и что может объяснить. Чекбоксы обращены к нему:
|
||||
«вы сверили числа», «у вас сохранен запрос». Подробный порядок действий
|
||||
остается в основной части.
|
||||
|
||||
Заголовки остальных разделов выбирайте по содержанию: «Для чего нужна
|
||||
витрина», «Найдите причину», «Как даг запускает ваши запросы». Число разделов
|
||||
и пунктов определяется упражнением. Ограничения объясняйте рядом с действием,
|
||||
которого они касаются; завершение опыта включает восстановление данных или
|
||||
удаление временных объектов, когда это требуется.
|
||||
|
||||
При вычитке сохраняйте состав результата, технические условия, способы
|
||||
проверки и самостоятельную часть работы. Новое упражнение или готовое решение
|
||||
под видом пояснения меняет учебный смысл и требует отдельного обсуждения.
|
||||
Формат инженерных issues из правил трекера относится к разработке стенда;
|
||||
учебные задания пишутся по этим правилам. Образцы:
|
||||
[дашборд Superset](../labs/optional/superset-dashboard.md) и
|
||||
[расследование подключения](../labs/optional/superset-missing-object.md).
|
||||
|
||||
## 3. Основная программа — семь ступеней
|
||||
|
||||
### Ступень 1. Построй пять витрин слоя DM
|
||||
@@ -64,7 +93,7 @@
|
||||
ступени предстоит написать при реализации программы. Полный собственный дашборд
|
||||
остается факультативом в разделе «Superset и BI».
|
||||
|
||||
### Ступень 3. Нарежь сессии сам
|
||||
### Ступень 3. Нарежьте сессии сами
|
||||
|
||||
До того как открыть стендовый SQL нарезки сессий в DDS, менти самостоятельно
|
||||
делит события на визиты. Сначала он сравнивает число своих сессий с эталоном
|
||||
@@ -75,7 +104,7 @@
|
||||
Форма — построить свое по ТЗ и провести расследование. Обратная связь состоит
|
||||
из счетной сверки с `VisitID` и ручного сопоставления границ.
|
||||
|
||||
### Ступень 4. Перепиши нарезку стенда
|
||||
### Ступень 4. Перепишите нарезку стенда
|
||||
|
||||
Менти удаляет и заново пишет SQL нарезки сессий DDS: расчет объема, пересборку
|
||||
и замену. Урок — изменить расчетную сущность внутри готового конвейера и
|
||||
@@ -86,7 +115,7 @@
|
||||
Форма — вычитание. Обратную связь дают `dq_check` и поштучная сверка,
|
||||
построенная на третьей ступени.
|
||||
|
||||
### Ступень 5. Сначала сторож, потом ломай: заказы
|
||||
### Ступень 5. Проверьте заказы перед изменением обработки
|
||||
|
||||
Сначала менти строит две недостающие DQ-проверки. Первая утверждает равенство
|
||||
«цена × количество = items_total». Вторая сверяет слой с источником по дням. Их
|
||||
|
||||
Reference in new issue
Block a user