Laboratorio de grafos de conocimiento¶
Pregunta de práctica. ¿Qué enlace, referencia o ruta de lectura debería corregir primero el mantenedor del CDI-BoK? Prioriza los cambios que permitan reconstruir evidencia o llegar desde una guía a su aplicación.
Abrir el CDI-BoK en el explorador
Carga el libro y recorre una relación¶
- El enlace carga el CDI-BoK directamente. Para cargarlo de forma manual o fijar otra versión, elige Cargar otra bóveda → GitHub. Introduce
jaforero/conversational-decision-intelligence-boky, en Opciones, la subcarpetadocs. Usamainpara el corpus vigente o una etiqueta para reproducir una revisión histórica. El repositorio es público y se puede cargar sin token, sujeto al límite de la API de GitHub. - Abre
learn/02-evidence-context.mdy sigue el enlace al módulo de diseño de experiencias. En el destino, revisa el backlink y su contexto. Repite conresearch/research-agenda.mdy busca el protocolo candidato de GraphRAG. - Clasifica un hallazgo. Un enlace roto apunta a un destino que no se resuelve. Una página sin enlaces entrantes desde el contenido puede seguir siendo accesible por navegación. Una relación implícita requiere comprobar ambos documentos antes de añadir un enlace editorial.
- Valida en el portal y en GitHub. Las convenciones de MkDocs y las traducciones
.en.mdpueden producir diferencias con un explorador genérico de Markdown. Registra origen, destino esperado, edición, evidencia, responsable y corrección propuesta. Verifica ambas ediciones después del cambio.
El panel Salud del explorador cuenta los archivos Markdown de ambos idiomas y señala las notas que carecen de enlaces entrantes y salientes reconocidos. El inventario editorial de abajo mide otra propiedad: páginas canónicas renderizadas que carecen de enlaces entrantes desde el contenido. Compara cada conteo con el mismo corpus y criterio. Para que los enlaces funcionen en el portal y en el explorador, las referencias Markdown en inglés apuntan al archivo .en.md correspondiente.
Entregable. Prepara un hallazgo reproducible y una corrección pequeña. Si una relación ya existe, úsala como control y documenta qué comprobaste.
Inspecciona el grafo editorial del CDI-BoK¶
El sitio genera un inventario JSON en cada compilación desde las páginas canónicas registradas, sus enlaces renderizados y los registros de fuentes y afirmaciones. Distingue cuatro relaciones: página que enlaza otra página, página que declara una fuente, página que declara una afirmación y afirmación que declara una fuente. Cada etiqueta describe lo que consta en el repositorio.
Descargar el grafo editorial en JSON
El campo pages_without_inbound_content_links enumera candidatos a revisión, excluyendo la portada. Los enlaces del menú se omiten y cada página cuenta una sola vez, en su edición canónica en español. Una referencia declarada permite rastrear procedencia. Su relevancia o fuerza exige revisar la evidencia.
Criterio de aceptación. Encuentra la ruta de una página a una fuente o afirmación, contrástala con el archivo original y documenta qué acción editorial cambiaría. El protocolo de GraphRAG describe la prueba adicional necesaria para evaluar recuperación basada en relaciones.