Как собрать курс на sudoteach

Курс на sudoteach делают разные авторы и в разных форматах: где-то это видео, за которым студент повторяет у себя, где-то текст с задачами в браузере. Единого шаблона нет и быть не должно. Но есть вещи, без которых курс не работает ни в одном формате — о них и речь.

Прежде чем писать первый урок

Ответьте себе на два вопроса и запишите ответы — они пойдут в описание курса.

Для кого это. Не «для всех, кто хочет изучить Python», а честно: человек с нуля? уже писавший код на другом языке? тот, кто знает синтаксис, но не собирал проектов? От этого зависит всё остальное — какие слова можно не объяснять, с чего начинать.

Что человек будет уметь в конце. Формулировка «изучит основы» ничего не значит. «Соберёт телеграм-бота, который принимает заказы и пишет их в таблицу» — значит. Если ответ не складывается в одну конкретную фразу, курс, скорее всего, ещё не придуман до конца.

Укажите уровень подготовки в настройках курса — по нему студентам подбираются рекомендации. Курс без уровня показывается всем подряд.

Как устроен урок

Один урок — одна мысль. Если в уроке три новые темы, студент не запомнит ни одной. Лучше три коротких урока, чем один длинный.

Начинайте с цели. Первая строка урока отвечает на вопрос «зачем я это читаю»: «К концу урока вы сможете читать данные из файла и не бояться ошибки, если файла нет». Человек должен понимать, куда идёт.

5–7 минут теории. Это примерно 4–6 тысяч знаков. Урок на 20 тысяч знаков без единой паузы дочитывают единицы — это видно по статистике прохождения. Если материал не влезает, значит это два урока.

Объясняйте «почему», а не только «как». Синтаксис студент найдёт в документации за минуту. Ценность автора — в том, чтобы объяснить, зачем эта конструкция нужна и когда её применяют.

Практика

В каждом уроке должно быть, что сделать руками. Формат зависит от курса:

• Задача с автопроверкой — студент пишет код прямо в браузере, платформа проверяет тестами. Лучший вариант для курсов по языкам программирования.
• Тест — проверяет понимание, а не память. Плохой вопрос: «какой символ обозначает комментарий». Хороший: «почему этот код выведет 3, а не 4».
• Задание для видео-курса — если студент работает у себя на компьютере, напишите в конце урока, что именно он должен получить и как проверить, что получилось правильно.

Урок без практики — это статья. Статьи тоже нужны, но курс из них не получается.

Если делаете задачи с автопроверкой

Условие должно быть однозначным. Если по тексту непонятно, что именно печатать и в каком виде, студент провалит задачу, зная решение. Показывайте пример ввода и вывода.

Заготовка кода — это не пустое поле. Дайте каркас: сигнатуру функции, вызов, комментарий на месте, где писать. Пустой редактор пугает новичка сильнее, чем сама задача.

Два набора тестов. Открытые тесты студент видит — они объясняют, что от него хотят. Скрытые прогоняются при сдаче и проверяют то, что открытые не покрывают: границы, пустые данные, отрицательные числа. Без скрытых тестов задача решается подгонкой под видимый пример.

Пишите понятные имена проверок. Студент увидит именно их, когда тест упадёт: «сумма пустого списка равна нулю» полезнее, чем «test_2».

Подсказки по нарастающей. У задачи можно завести три подсказки: первая направляет мысль, вторая называет конкретный шаг, третья разбирает решение. Они открываются после неудачных попыток — сначала человек думает сам. Это сильно снижает шанс, что он бросит на середине.

Разбор и финал

После решения покажите, как это делают нормально. Студент может решить задачу криво и закрепить плохую привычку. Короткий разбор «а вот как короче и почему» — самая недооценённая часть курса.

Итоговый проект. Курс без финального проекта заканчивается ничем. Даже маленький проект, который собирает всё пройденное вместе, даёт человеку ощущение результата — и то, что можно показать.

Перед отправкой на модерацию

Пройдитесь по списку:

• В курсе есть хотя бы один урок, и ни один урок не пустой.
• У курса заполнено полное описание: для кого, что получится в конце, программа.
• Указан уровень подготовки.
• Есть обложка.
• В курсе есть практика: задачи, тесты или задания для самостоятельной работы.
• Вы прошли курс сами от начала до конца глазами студента — кнопка «Посмотреть как студент» в редакторе урока.

Модерация обычно занимает до суток. Если курс вернули — в замечаниях будет написано, что поправить.

Что помогает после запуска

В разделе аналитики курса видно, на каком уроке студенты останавливаются, и какие задачи проваливают чаще всего. Урок, на котором отваливается половина, почти всегда можно переписать. Задача с процентом решивших ниже 30 — либо сформулирована непонятно, либо требует того, чего в курсе не объясняли.