From 1b95ce456ca65a4b0469dc771c271701b8cd8e1e Mon Sep 17 00:00:00 2001 From: Dmitry Dementev Date: Sun, 13 Sep 2026 11:26:55 -0400 Subject: [PATCH] =?UTF-8?q?docs(labs):=20=D1=81=D0=BE=D0=BA=D1=80=D0=B0?= =?UTF-8?q?=D1=89=D0=B5=D0=BD=D1=8B=20=D0=BF=D1=80=D0=B0=D0=B2=D0=B8=D0=BB?= =?UTF-8?q?=D0=B0=20=D0=BD=D0=B0=D0=BF=D0=B8=D1=81=D0=B0=D0=BD=D0=B8=D1=8F?= =?UTF-8?q?=20=D0=B7=D0=B0=D0=B4=D0=B0=D0=BD=D0=B8=D0=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Зачем: оставить только необходимые ориентиры для автора учебного текста. Что: раздел сокращен до трех согласованных абзацев, ссылки на оба образца сохранены. Проверка: git diff --check прошел; проверен diff единственного измененного файла. --- docs/specs/2026-09-01-labs-program.md | 32 +++++++-------------------- 1 file changed, 8 insertions(+), 24 deletions(-) diff --git a/docs/specs/2026-09-01-labs-program.md b/docs/specs/2026-09-01-labs-program.md index 68bc651..87f2627 100644 --- a/docs/specs/2026-09-01-labs-program.md +++ b/docs/specs/2026-09-01-labs-program.md @@ -42,32 +42,16 @@ ### Как писать задания -Задание обращается к учащемуся на «вы». Начните с «Чему учит»: назовите -умение, которое он получит. Затем объясните, для чего нужен результат, и -ведите читателя по действиям. Термины раскрывайте там, где без них нельзя -понять следующий шаг. Историю разработки оставляйте в рабочих справочниках. +Пишите для учащегося: объясняйте, чему он научится, зачем нужны действия +и как понять результат. Историю разработки оставляйте за пределами задания. -Раздел «Как проверить себя» описывает способ проверки: что выполнить, -с чем сравнить и где искать причину расхождения. Если проверка и есть ход -исследования, сохраните ее в шагах, без повторного раздела. В конце задания -«Что должно получиться» помогает учащемуся оценить результат: что у него -работает, что он проверил и что может объяснить. Пишите о наблюдаемом -результате: «числа на графике совпадают с запросом», «вы можете объяснить -причину ошибки». Местоимение «вы» нужно там, где оно помогает обратиться -к читателю. Подробный порядок действий остается в основной части. +«Как проверить себя» описывает действия для проверки и поиска ошибок. +«Что должно получиться» — результат работы и то, что учащийся теперь может +объяснить. Если проверка уже встроена в шаги упражнения, повторять ее +отдельным разделом не нужно. -Заголовки остальных разделов выбирайте по содержанию: «Для чего нужна -витрина», «Найдите причину», «Как даг запускает ваши запросы». Число разделов -и пунктов определяется упражнением. Ограничения объясняйте рядом с действием, -которого они касаются; завершение опыта включает восстановление данных или -удаление временных объектов, когда это требуется. - -При вычитке сохраняйте состав результата, технические условия, способы -проверки и самостоятельную часть работы. Новое упражнение или готовое решение -под видом пояснения меняет учебный смысл и требует отдельного обсуждения. -Формат инженерных issues из правил трекера относится к разработке стенда; -учебные задания пишутся по этим правилам. Образцы: -[дашборд Superset](../labs/optional/superset-dashboard.md) и +Остальные заголовки и структуру выбирайте по содержанию. Образцы — задания +про [дашборд Superset](../labs/optional/superset-dashboard.md) и [расследование подключения](../labs/optional/superset-missing-object.md). ## 3. Основная программа — семь ступеней