Когда я преподаю программирование и другие цифровые технологии детям и подросткам, я регулярно сталкиваюсь с необходимостью разработки четких, простых для понимания примеров, которые можно быстро использовать в проектах учащихся. Это не всегда легко. Однако несколько простых правил позволяют достичь цели. Слишком часто, когда я ищу ресурсы в Интернете, я трачу много времени, переходя от страницы к странице, чтобы найти базовый пример того, что я хочу сделать. Эти странствия позволили мне определить некоторые правила, которые я стараюсь систематически соблюдать.

1 — Хорошо: покажите окончательный результат перед началом объяснений

Представьте себе поход, извилистую тропу, по которой не обязательно легко следовать. Представьте, что вас сопровождает гид. Единственная проблема в том, что вы не знаете, куда идете, и можете доверять только ему. Вы продвигаетесь вперед шаг за шагом, даже не понимая, почему.
Это проблема большинства руководств. Название дает вам первое представление о том, что предлагается, но иногда оно немного расплывчато, и было бы гораздо практичнее, прежде чем перейти к сути вопроса, четко показать результат. Я очень часто это понимаю, глядя на музыкальные уроки. Иногда требуется двадцатая минута, чтобы услышать окончательный результат, который, возможно, не соответствует тому, что я хочу сделать. Размещенный в начале видео пример был бы ценным индикатором.

2 — Плохо: ограничьтесь одним примером без минимальных доработок.

Недавно я позволил студентам провести собственное исследование того, как реализовать для Micro:bit цикл в микропитоне. Я не думал, что это будет так сложно. Все они нашли один и тот же метод, а именно:

для i в диапазоне (0,5):
…

Вот и все!
Первая проблема: во всех примерах используется «i», и все считают, что это единственная возможная используемая переменная. Никаких «для x в диапазоне (0,5)», например… Точность была бы полезна.
Вторая возникшая проблема: мы хотим перейти от 2 к 2 от 0 к 100, а не к 1 к 1. Количество страниц подробное описание правильного синтаксиса для использования и появление в первых результатах поисковой системы — да, молодые люди, как правило, довольны первыми страницами — было довольно небольшим.

для x в диапазоне (0, 100, 2):
…

Последняя проблема, с которой мы столкнулись, заключалась в том, что мы, казалось, находились в только растущем мире. На этот раз путем экспериментов они обнаружили, что можно использовать убывающую петлю.

для x в диапазоне (10, 0, -1):
…

Или даже:

для x в диапазоне (10, -10, -1):
…

Та же проблема возникла с Scratch, где поиск скрипта для рисования круга всегда приводил к одному и тому же результату: очень простой скрипт, который позволял рисовать круг, но всегда один и тот же круг и без возможности изменить его размер, даже на страницах «профессиональных» авторов туториалов.
Это может показаться удивительным. Действительно, мы можем и имеем право пробовать, пробовать, пока не найдем правильный синтаксис, но переход от одного синтаксиса к другому не всегда естественен для детей и многие не решаются. Лично мне мои навыки в коде помогли бы угадать необходимый синтаксис, но это уже требует изучения одного или нескольких языков.

3 — хорошо: не только показывайте свои навыки/думайте о пользователе

Иногда возникает соблазн поддаться «демонстрационному» эффекту, желанию показать свои навыки в туториале. Зачем довольствоваться простым «привет, мир», если я могу отобразить его мозаикой и всеми цветами радуги. Верно, но на данном этапе ваш читатель хочет только одного: отобразить на экране «hello world». Остальные украшения предполагают знания, которыми он еще не обладает и которые могут исказить его понимание единственной интересующей его команды.
Например, я помню туториал для micro:bit, где после нескольких базовых команд исходного языка автор перешел сразу к другому, гораздо более сложному, требующему установки специфических библиотек. Для введения, предназначенного для детей младшего возраста, эффект был довольно неудачным. Не бывает неинтересно или невозможно показывать сложные вещи. Это даже рекомендуется, но для этого есть время, и это не то время, когда ученик начинает.

4 – хорошо: творчество и использование

Наконец, вопрос «в чем смысл?» должны быть решены к этому времени творческим путем решения сложности. Если простое «hello world» в Python позволяет понять синтаксис команды «print», что мы можем с ней сделать помимо простого факта вывода текста на экран?

Так что будьте изобретательны. Как только учащийся хорошо понимает синтаксис, мы можем разрабатывать более сложные проекты, веселые, научные, художественные… Подумайте об иностранном языке. Прежде чем вы сможете написать рассказ или стихотворение, потребуется немного времени и синтаксиса, но этот последний шаг помогает развивать изучение языка в очень творческой среде.