Creador de esquemas para tutoriales

Obtén un esquema de tutorial estructurado en Markdown, del objetivo a la tarea de práctica.

Funciona en tu navegador
Sin subidas
Sin cuenta

Cargando tu herramienta del navegador…

Qué hace Creador de esquemas para tutoriales

Los tutoriales que se recuerdan siguen una estructura didáctica: decir qué sabrá hacer el alumno, enumerar lo que necesita antes, recorrer los pasos, resumir y darle algo que practicar. Introduce la tarea, pega tus pasos en bruto uno por línea y el generador escribe esa estructura como un esquema en Markdown.

La numeración y las viñetas de tus pasos se quitan y se vuelven a numerar, un “How to” inicial (en inglés) se quita de la tarea para que el título no lo repita y, si aún no has escrito ningún paso, aparecen pasos sugeridos, marcados como sugerencias. Los encabezados y las líneas que terminan en dos puntos no cuentan como pasos. Los requisitos previos van en “Más opciones”.

Ejemplo

Entrada

¿Qué sabrán hacer los alumnos?: conectar tu calendario
Pasos:
1. Abre Ajustes y elige Integraciones
2. Haz clic en Conectar junto a Google Calendar
3. Aprueba el acceso en la ventana emergente

Resultado

# Cómo conectar tu calendario

## Objetivo de aprendizaje
Al terminar este tutorial, el objetivo para los usuarios nuevos es conectar su calendario sin ayuda.

## Resumen
- Has completado 3 pasos para conectar tu calendario
- Comprueba que el resultado coincide con lo que mostraba el último paso

Sin público indicado, el objetivo dice “los usuarios nuevos”. Las secciones Requisitos previos, Pasos y Tarea de práctica van entre estas y después de ellas.

Cómo usar Creador de esquemas para tutoriales

Introduce lo que sabrán hacer los alumnos, como “conectar tu calendario”.
Pega tus “Pasos” uno por línea, añade un “Público” y enumera los “Requisitos previos” en “Más opciones”.
Copia el esquema o usa “Descargar .md” y graba a partir de él.

Conviene saber

Los pasos se usan tal como están escritos, salvo la primera letra, que pasa a mayúscula. Divide antes las líneas que contienen dos acciones; el Comprobador de complejidad de instrucciones las señala.
El esquema no tiene tiempos. Para la duración, pon los mismos pasos en la Calculadora de duración de videos de formación.
Sin requisitos previos, se añaden dos sugerencias bajo una nota que dice que no se ha indicado ninguno. Sustitúyelas, o borra la sección si la tarea no necesita nada.

Preguntas sobre Creador de esquemas para tutoriales

¿Cómo hago el esquema de un tutorial?

Escribe primero el objetivo de aprendizaje, luego enumera los requisitos previos y después los pasos en orden, con una acción cada uno. Termina con un resumen breve y una tarea de práctica para que los alumnos repitan la habilidad sin el video.

¿Por qué añadir una tarea de práctica al final de un tutorial?

Ver no es lo mismo que hacer. Una tarea de práctica, como repetir los pasos con otros valores, obliga al alumno a recordar el proceso y le muestra si puede arreglárselas sin el video.

¿Qué requisitos previos debe enumerar un tutorial?

Todo lo que impida empezar a un alumno: el rol o el permiso necesarios, el plan o la función que debe estar activada, y los archivos o datos que hay que tener preparados. Enumerarlos evita que la gente falle en el paso dos.

¿Puedo convertir el esquema en una guía escrita?

Sí. El Markdown sirve como esqueleto de un artículo de ayuda: pégalo en tu herramienta de documentación y añade una captura de pantalla bajo cada paso. Polysh también puede crear una guía paso a paso directamente a partir de una grabación de pantalla.