Escrevendo uma descrição de aula que o Tutorial Builder entende

O Tutorial Builder escreve um tutorial passo a passo completo a partir da sua descrição. Alguns detalhes antecipados economizam muita troca de mensagens.

Inclua estas cinco coisas

1. Para quem é – série ou idade. "5º ano" ou "10–11 anos."
2. O que vão construir – o programa finalizado em uma frase. "Um alarme de umidade da planta que mostra uma carinha triste quando o solo está seco."
3. O que vão aprender – o conceito. "Usar if/else com a leitura de um sensor."
4. Qual hardware – um micro:bit simples, ou um kit da Forward Education e quais módulos. "Climate Action Kit com o sensor de umidade."
5. Duração ou número de etapas – "Cerca de 8 etapas, um período de aula."

Juntando tudo:

Um tutorial para alunos do 5º ano, com cerca de 8 etapas. Eles constroem um alarme de umidade da planta usando o sensor de umidade do Climate Action Kit: quando o solo está seco, o micro:bit mostra uma carinha triste, caso contrário uma carinha feliz. O objetivo é aprender if/else com a leitura de um sensor. Eles já usaram o micro:bit antes, mas não o kit.

Depois refine conversando

O primeiro rascunho é um ponto de partida. Converse com ele como um coautor:

• "A etapa 3 está grande demais — divida em duas."
• "Adicione uma etapa em que eles preveem o que vai acontecer antes de executar."
• "Use palavras mais simples na introdução."
• "Adicione um desafio no final: fazer o alarme apitar."

Verifique a aba Steps quanto à redação e a aba Solution blocks para garantir que o programa é o que você quis dizer. Preview in MakeCode mostra exatamente o que os alunos vão receber.

Escolhendo extensões

Você não escolhe as extensões manualmente. Se sua descrição mencionar hardware de kit, o Tutorial Builder inclui a extensão certa; uma aula com micro:bit simples não recebe nenhuma. Se ele escolheu errado, basta dizer: "Esta aula não precisa do kit."

Bons hábitos

• Um conceito por tutorial. Dois tutoriais curtos são melhores do que um longo.
• Diga o que os alunos já sabem para que as etapas não expliquem novamente o básico.
• Dê o nome que quiser ao tutorial se não gostar do título sugerido – clique nele para editar.
• Peça uma etapa de "desafio" ou "extensão" no final para quem termina rápido.