Cómo construimos las lecciones
Toda lección recorre el mismo proceso antes de publicarse.
El proceso
1Especificación
Una persona describe qué debe enseñar la lección: el objetivo, los conceptos que no se pueden omitir, el tipo de práctica y lo que queda fuera de alcance.
2Borrador
El borrador se escribe contra esa especificación. Su estructura se comprueba por máquina: una lección sin bloques de teoría, práctica o pistas no pasa.
3Validación
Comprobaciones automáticas verifican la estructura, el grafo de prerrequisitos y que ningún texto esté fijado fuera de los archivos de traducción.
4Revisión técnica
Las afirmaciones se revisan por exactitud. Simplificar está permitido; afirmar algo falso, no.
5Traducción
Cada lección se traduce con un glosario fijo, para que la terminología sea consistente en todo el curso.
6Publicación
La lección sale solo si pasan todas las comprobaciones. Si fallan, falla la compilación: el contenido roto no llega al sitio.
Qué se comprueba automáticamente
Cada lección debe validar contra un esquema, cada prerrequisito debe existir, cada tarea debe tener al menos dos pistas, cada cadena visible debe existir en todos los idiomas y cada valor de simulación debe coincidir con el texto que lo describe.
Límites, dichos con claridad
Las lecciones se escriben con ayuda automática y luego se revisan. Eso significa que puede haber errores, y preferimos decirlo a fingir lo contrario. Si encuentras uno, avísanos: la corrección se aplica a la lección, no se esconde.