Skip to content

Anatomía de una unidad

Lupo Montero edited this page Jun 7, 2019 · 6 revisions

Recomendamos que cada unidad empiece con una lectura de apertura y termine con una de cierre.

Estructura de archivos:

0X-topic-slug                       # tópico
├── 01-titulo-corto-unidad/         # unidad
│   ├── 00-apertura                 # parte
│   |   └── README.md
│   ├── 01-titulo-corto
│   |   └── README.md
│   ├── 02-practice
│   |   ├── 01-un-ejercicio
│   |   ├── 02-otro-ejercicio
│   |   └── README.md
│   ├── 03-some-quiz
│   ├── 04-ejercicios-guiados
│   ├── 05-solucionario
│   ├── 06-requizz
│   └── 07-cierre
├── 02-titulo-corto-unidad/
├── 03-titulo-corto-unidad/
└── README.md

Anatomía de una parte (actividad) de una unidad

Cada parte de cada unidad debe tener su propio README.md. La primera línea en el README.md debe ser un h1 con el título completo de la parte.

h1 (título) *
ul *
  li (tipo) *
  li (formato) *
  li (duración) *
h2 (objetivos de aprendizaje)
ul
  li (objetivo de aprendizaje 1)
  li (objetivo de aprendizaje 2)
  li (objetivo de aprendizaje n)
hr *
body (el cuerpo/contenido)

* obligatorio

Tipos

seminario/seminar (deprecated/legacy)

Un seminario es lo más parecido a una clase presencial tradicional. Los seminarios son guiados por unx o más instructorxs.

lectura/read

Las lecturas son artículos de contenido que pueden incluir videos, imágenes y otros soprtes, embebidos o como vínculos externos.

práctica/practice

Las prácticas principalmente ejercicios y pueden tener diferentes entornos: js, web, node, ...

cuestionario/quiz

Los cuestionarios a corto plazo se manejarán como links a Google Forms. Más adelante se implementará una manera más apropiada para poder incluir en nuestro LMS.

taller/workshop (deprecated/legacy)

Los talleres (o workshops) son sesiones guiadas o no guiadas (self-paced) durante las cuales las alumnas realizan una actividad prolongada, como implementación, diseño o investigación. Al final de un taller o grupo de talleres normalmente se cierra con una demo o presentación.

Formatos

Cualquiera de los tipos de contenido anteriores pueden darse (o proponerse) en dos formatos:

guiado/guided (deprecated/legacy)

Los contenidos guiados son aquellos donde la clase es dirigida por unx o más instructorxs. Los seminarios son siempre guiados, mientras que los talleres, lecturas o ejercicios pueden ser guiados o no.

self-paced

Los contenidos self paced (a tu propio ritmo) son aquellos que están dirigidos por las alumnas y por lo general podrían ver estas partes en su propio tiempo. En este formato, lxs instructorxs tienen el rol de acompañar, guíar y apoyar, pero son ellxs quienes dirigen la actividad.