R&D LAB Método En uso Construido para nuestro propio equipo
iiterate Handbook
Un tema convertido en manual de aprendizaje bilingüe con registro de finalización
Un tema, un manual: lecciones con fuentes, una prueba de comprensión y una confirmación, en alemán e inglés, con seguimiento hasta el final.
- 2idiomas en cada lección, intercambiables al instante
- 3paneles en el lector: navegación, lección, espacio de trabajo
- 5herramientas por lección: notas, comentarios, lista, enlaces, marcas
- 1tema por manual
Página de inicio de la biblioteca con una serie de cinco capítulos sobre seguridad y confianza, escritos para nuestro propio equipo. Su contenido es interno y no se describe aquí.
Por qué se publica
Vendemos IA y comunicación técnica. El manual es la prueba de ambas cosas en una tarea poco vistosa: convertir conocimiento disperso en material estructurado, que cita sus fuentes y cuyo recorrido puede demostrarse. El modelo de lenguaje no escribe en el vacío, sino que rellena una estructura fija en la que una fuente ausente se ve como un hueco. Si quiere estructurar la incorporación, la formación interna o la sensibilización en protección de datos y seguridad de la información, aquí ve cómo lo construimos para nuestro propio equipo.
El conocimiento experto vive en las cabezas, en presentaciones y en páginas wiki que nadie puede terminar nunca. Una formación es una cita; después quedan una lista de asistentes y las preguntas que se hicieron en la sala. iiterate Handbook convierte un tema complejo en un manual de aprendizaje interactivo en alemán e inglés. Empieza con una misión y una aclaración previa: para quién, con qué profundidad, en qué idiomas y apoyado en qué normas y leyes. Después vienen la investigación de fuentes, módulos en orden de aprendizaje y lecciones con una misma estructura fija, un glosario y un grafo de temas que conecta conceptos recurrentes entre lecciones, y un lector de tres paneles con notas, comentarios, marcadores y un registro de finalización. Un modelo de lenguaje ayuda a redactar y estructurar las lecciones; la plantilla exige referencias en el texto y una lista de fuentes, y las preguntas abiertas de quienes aprenden se recogen para la siguiente revisión.
La decisión
Una lección solo termina cuando alguien la ha confirmado
Una página wiki no sabe si alguien la ha leído, y una presentación rara vez indica de dónde salen sus afirmaciones. Ambas cosas son inofensivas en conocimiento general y se vuelven incómodas en cuanto una organización tiene que demostrar que su equipo conoce una norma. Por eso la decisión inicial fue construir cada lección como una unidad con seguimiento y no como una página.
Cada lección termina con una breve prueba de comprensión sobre su contenido. Solo cuando se supera puede confirmarse la lección: un nombre, la declaración de que se ha leído y comprendido, y la fecha. La barra de progreso de la cabecera cuenta lecciones confirmadas, no abiertas, y un botón exporta a partir de ellas una tabla con nombre, manual, módulo, lección y fecha.
Donde un error tiene consecuencias se añade una lista de comprobación. Si está marcada como obligatoria, la confirmación queda bloqueada hasta marcar cada punto. El mismo rigor rige para las referencias: la plantilla prevé citas directamente en cada sección y una lista de fuentes al final. El modelo de lenguaje rellena esa estructura, y una sección sin referencia se nota al leer como un hueco en lugar de perderse en el texto.
Lo que esto no es también forma parte. La confirmación es una declaración propia con un nombre escrito, no una prueba con inicio de sesión, y la prueba de comprensión es un breve test de opción múltiple, no un examen. Notas, progreso y confirmaciones viven en el navegador hasta que alguien los vuelve a escribir en los archivos del manual. No hay gestión de usuarios para muchas personas.
Nadie puede terminar una página wiki. Una lección, sí.
Del tema al manual
Seis pasos, y la redacción solo empieza en el quinto
- 01 Aclaración previa Se deja por escrito para quién es el manual, qué roles existen, qué profundidad debe tener, en qué idiomas, qué temas afines incluye, dónde hacen falta listas obligatorias y qué normas y leyes se citan. De ahí sale una propuesta de módulos y lecciones que se aprueba antes de escribir.
- 02 Misión Una breve misión describe qué deben saber hacer al final quienes aprenden, por qué les importa, desde dónde parten y cómo se reconoce que se ha alcanzado el objetivo. Cada lección se refiere a ella.
- 03 Fuentes La investigación termina en una tabla de fuentes con nivel de confianza y uso. Los vídeos pueden transcribirse a partir de sus subtítulos, y los documentos aportados profundizan los módulos correspondientes.
- 04 Estructura Los módulos siguen el orden de aprendizaje, porque los posteriores se apoyan en los anteriores. Cada lección trata exactamente una cuestión bien acotada y nombra los temas recurrentes que toca.
- 05 Lecciones Un modelo de lenguaje redacta cada lección siguiendo la estructura fija, con alemán e inglés en el mismo archivo. La lección es una página HTML autónoma que también puede abrirse e imprimirse fuera del lector.
- 06 Construir Un script lee todas las lecciones, calcula el progreso y el grafo de temas y genera el lector como un único archivo. La página de inicio de la biblioteca se regenera cada vez.
Qué contiene cada lección
El lector en tres paneles
A la izquierda están las lecciones por módulo, con búsqueda y una segunda pestaña para el glosario. En el centro se muestra la lección, y a la derecha el espacio de trabajo de esa lección concreta: notas que se guardan solas, comentarios que pueden anclarse a un pasaje resaltado, una lista propia, las fuentes de la lección junto con enlaces propios y las marcas colocadas. Un marcador solo se crea cuando alguien guarda expresamente un texto resaltado.
El modo foco oculta ambos paneles laterales, e imprimir produce solo la lección, nunca la navegación. En modo edición se pueden cambiar el texto y las notas al margen, resaltar pasajes y mover notas; esos cambios pasan a formar parte del archivo de la lección al volver a escribirse. La barra inferior cuenta los cambios que por ahora solo están en el navegador, dos en esta captura.
Los conceptos recurrentes conectan las lecciones
Cada lección nombra los temas que toca. Al construir, forman un grafo de temas: un tema es un término del glosario o un concepto que nombran al menos dos lecciones, y se enlaza con cada lección en la que aparece. Las entradas del glosario registran automáticamente en qué lecciones aparecen, aunque nadie lo haya pensado al escribir.
En el lector, el glosario está a la izquierda de la lección, cada término con su definición en ambos idiomas y enlaces a las lecciones que lo usan. La vista general muestra las mismas conexiones como grafo: temas como cuadrados, lecciones como puntos del color de su módulo, con filtros, búsqueda y un clic que abre la lección.
Esto solo funciona si la misma cosa se llama igual en todas partes. Por eso los temas de una serie se nombran una vez y se reutilizan literalmente en todos los capítulos; dos nombres distintos para la misma cosa dan lugar a dos temas.
Qué cambia frente a un material de formación
Material de formación habitual
- Diapositivas sin fuentes, o con una lista final que nadie sabe asociar a una afirmación.
- Un solo idioma, o dos versiones que se separan más con cada cambio.
- Una lista de asistentes como constancia, pero nada sobre quién ha trabajado qué.
- Preguntas planteadas en la sesión que se pierden cuando termina.
- Correcciones que acaban en una copia y nunca en el original.
Manual
- Referencias en cada sección y una lista de fuentes por lección.
- Alemán e inglés en el mismo archivo de lección, intercambiables en el lector.
- Una confirmación por lección con nombre y fecha, tras una prueba de comprensión, exportable como tabla.
- Preguntas abiertas por lección, reunidas en una lista para la siguiente revisión.
- Cambios en el texto que se vuelven a escribir en el archivo de la lección y valen así para todos.
Biblioteca
Series y capítulos en lugar de manuales sueltos
Un tema sigue siendo un manual. Cuando varios temas van juntos, se enlazan como capítulos ordenados de una serie sin que uno sobrescriba a otro. Cada manual de una serie recibe bajo su cabecera una barra de capítulos que salta a los demás capítulos, y la página de inicio de la biblioteca muestra cada serie como una secuencia de tarjetas de capítulo con color, extensión y progreso, junto a los manuales independientes y una breve guía interactiva.
Si un capítulo ya está construido o solo planificado no se guarda en ningún sitio como estado mantenido. Se deduce al construir, según exista o no un lector para ese capítulo. Un capítulo planificado aparece por tanto como planificado hasta que se ha construido de verdad, y no puede pasar por disponible por error.
La biblioteca que se ve contiene una serie de varias partes sobre seguridad y confianza, escrita para nuestro propio equipo. Este artículo solo muestra una lección de ella, de conocimiento general.
Dónde encaja
- Incorporación de nuevas personas a las formas de trabajo, herramientas y normas internas.
- Instrucción de socios y proveedores sobre las condiciones en las que trabajan con datos o sistemas.
- Sensibilización en protección de datos y seguridad de la información cuando debe constar quién ha confirmado qué lección.
- Traspaso de un proyecto de software al equipo que lo operará, con lecciones sobre su estructura y procedimientos.
- Material de acompañamiento de talleres que sigue sirviendo como consulta después de la sesión.
Créditos de imagen: todas las imágenes son capturas de nuestra propia aplicación. El OWASP Top 10 es un proyecto de la OWASP Foundation; la lección mostrada es material didáctico propio sobre él.
Por qué se publica
Lo que esto significa para su proyecto
Más del laboratorio
Método Event Scout Un modelo de lenguaje lee las páginas de eventos; todo lo demás es código fijo. Queda una lista breve de dónde merece la pena un día presencial. 
Investigación aplicada Vellum Bordes, perspectiva, luz y texto se calculan en el teléfono. Un documento solo sale del dispositivo cuando alguien lo envía. 
Diseño computacional Atlas EV1 Doce capítulos desmontan un coche eléctrico, hasta una sola celda. Sin archivos de modelo ni texturas: 327 piezas de una tabla de medidas. ¿El conocimiento de su organización vive en cabezas y presentaciones que cada persona nueva tiene que volver a preguntar? Para eso existe un piloto.
Contactar