Cómo escribir una descripción de lección que Tutorial Builder entienda

Tutorial Builder escribe un tutorial completo paso a paso a partir de tu descripción. Unos cuantos detalles de antemano ahorran mucho ida y vuelta.

Incluye estas cinco cosas

1. Para quién es – curso o edad. "5.º de primaria" o "10–11 años."
2. Qué van a construir – el programa terminado en una frase. "Una alarma de humedad para plantas que muestra una cara triste cuando la tierra está seca."
3. Qué van a aprender – el concepto. "Usar if/else con una lectura de sensor."
4. Qué hardware – un micro:bit normal, o un kit de Forward Education y qué módulos. "Climate Action Kit con el sensor de humedad."
5. Cuánto dura o cuántos pasos – "Unos 8 pasos, un período de clase."

Todo junto:

Un tutorial para estudiantes de 5.º de primaria, de unos 8 pasos. Construyen una alarma de humedad para plantas usando el sensor de humedad del Climate Action Kit: cuando la tierra está seca, el micro:bit muestra una cara triste; si no, una cara feliz. El objetivo es aprender if/else con una lectura de sensor. Ya han usado el micro:bit antes, pero no el kit.

Luego perfecciónalo conversando

El primer borrador es un punto de partida. Háblale como a un coautor:

• "El paso 3 es demasiado grande — divídelo en dos."
• "Añade un paso donde predigan qué va a pasar antes de ejecutarlo."
• "Usa palabras más sencillas en la introducción."
• "Añade un desafío al final: que la alarma emita un pitido."

Revisa la pestaña Steps para ver la redacción y la pestaña Solution blocks para asegurarte de que el programa es lo que querías decir. Preview in MakeCode muestra exactamente lo que verán los estudiantes.

Elegir extensiones

Tú no eliges las extensiones a mano. Si tu descripción menciona hardware del kit, Tutorial Builder incluye la extensión correcta; una lección con micro:bit normal no lleva ninguna. Si se equivocó, simplemente dilo: "Esta lección no necesita el kit."

Buenos hábitos

• Un concepto por tutorial. Dos tutoriales cortos son mejores que uno largo.
• Indica lo que los estudiantes ya saben para que los pasos no vuelvan a explicar lo básico.
• Ponle tú mismo el nombre al tutorial si no te gusta el título sugerido — haz clic en él para editarlo.
• Pide un paso de "desafío" o "ampliación" al final para quienes terminen rápido.