4GeeksAcademy
LearnPack init changes
When opening the table of contents file the user should see this message at the first line:
Write or paste your table of content below this line, each topic should be defined on a new line, here is an example:
Tabla de contenido proporcionada por el usuario
- Cada línea que no sea un ocmentario va a ser un nuevo tópico
- Cada tópico puede resultar en un número N de lecciones, quizzes o código dependiendo de su densidad, si es un tema muy denso, pues debería separarse en más pasos
Parámetros a tener en cuenta para saber cuándo una lección necesita ser refactorizada
- Density: how many concepts and words the lesson has
- Objectives: Up to 2 objectives per lesson
- Flesch-Kincaid test (expected result: sexto grado)
- Ningún párrafo debería ser mayor a 4 sentencias
Target Audience
Si la persona quiere usar IA, se le pregunta el target audience
Workflow
-
el usuarsio da los topicos o la IA genera la primera version
-
el usuario interactua con la IA para conseguir el indice de contenido final
-
Luego de creados todos los readme se hace un revision de legibilidad y extension de los archivos.
- Máximo 3 iteraciones por lección
- Si más de un párrafo dentro de la lección superan el 10.0 en el test, iterar estos párrafos
- Max grade: 8 es el grado que idealmente deberíamos obtener +- 2.0
- Se procesa cáda párrafo aplicando el test de Flesch-Kindaid, si amerita reescritura, se reemplaza el párrafo que puede ser reescribirlo o separarlo. Se crea un README.es.json con los parrafos, su posicion en el readme y su score.
-
Leugo de hacer la revisión de legibilidad, se abre LearnPack y puedes empezar a editarlo.
The AI should generate the exercises based in the duration, even if te course is big. It is better to tell an estimated number of exercises to the AI, so it doesn't think and just apply
- Another question if you are using AI to generate the tutorial are the rules for the AI, the LearnPack rules