Una base de conocimiento sin una estructura deliberada es una colección de artículos, no un sistema de documentación. Los lectores pueden encontrar artículos individuales mediante búsqueda, pero no pueden navegar de forma coherente, construir comprensión progresivamente ni descubrir lo que no saben buscar. La estructura es lo que convierte el contenido en un recurso — para los lectores humanos y, cada vez más, para los motores de búsqueda y sistemas de IA que lo rastrean y citan.
Este artículo explica cómo planificar y organizar una base de conocimiento para que sirva bien a los lectores — no solo en el lanzamiento, sino a medida que crece.
Empieza con los objetivos de los lectores, no con las características del producto
El error de estructuración más común es organizar una base de conocimiento en torno a cómo se construye el producto en lugar de en torno a lo que los lectores intentan hacer. Un menú de navegación que refleje la arquitectura interna del producto tiene todo el sentido para el equipo que lo ha construido. Rara vez tiene sentido para los demás.
Empieza en cambio con una lista de objetivos para lectores. ¿Cuáles son las diez, veinte o cincuenta cosas que los lectores suelen necesitar hacer? Agrupa esos objetivos en grupos. Esos grupos son la base de tu estructura de navegación.
Por ejemplo, en lugar de una sección principal llamada "Configuración" que contiene todas las opciones de configuración, podrías tener secciones llamadas "Empezar", "Gestionar tu contenido" y "Controlar el acceso" — cada una de las cuales puede basarse en la configuración, pero organizarla en torno a lo que los lectores intentan hacer.
Los tres niveles de estructura
Una base de conocimiento bien estructurada cuenta con tres niveles de organización que trabajan juntos.
Estructura de navegación
La estructura de navegación es la organización de nivel superior: las categorías y subcategorías que los lectores utilizan para navegar y orientarse. Debería reflejar los modelos mentales del lector, no la arquitectura del producto. Pon a prueba tu estructura de navegación con lectores reales antes de comprometerte con ella: si no pueden predecir dónde encontrar algo, la estructura necesita replantearse.
Mantén el nivel superior poco profundo. Cinco a ocho categorías de nivel superior es un rango viable para la mayoría de las bases de conocimiento. Más que eso, los lectores se enfrentan a una sobrecarga cognitiva antes incluso de empezar. Menos de cinco puede significar que las categorías son demasiado amplias para ser útiles.
Este rango se aplica por superficie del producto, no como un límite absoluto. Una plataforma con varios productos distintos puede necesitar razonablemente entre cinco y ocho categorías de nivel superior para cada producto, conectadas por un maniobrador o estructura de aterrizaje de nivel superior — en lugar de forzar todo en una lista superficial.
Estructura a nivel de artículo
Cada artículo tiene su propia estructura interna. Esa estructura debe coincidir con el tipo de contenido: las guías prácticas tienen pasos numerados, los artículos de referencia tienen estructuras de tablas consistentes, los artículos conceptuales tienen secciones lógicas en prosa. Los lectores desarrollan el reconocimiento de patrones — cuando todas las guías de instrucciones tienen un aspecto estructuralmente igual, pueden navegar por cualquier guía sin tener que reaprender la maquetación.
Utiliza encabezados para crear una estructura escaneable dentro de cada artículo. La mayoría de los lectores no leen la documentación de forma lineal: buscan la sección relevante para ellos y leen desde ahí. Un artículo sin encabezados obliga a cada lector a empezar desde el principio cada vez.
Los encabezados descriptivos y consistentes también importan para sistemas que no son humanos. Los motores de búsqueda usan encabezados para entender qué cubre una página, y los asistentes de IA se basan en ellos para aislar la sección específica que responde a una pregunta dada, en lugar de resumir un artículo completo de forma indiscriminada.
Estructura de reticulación
Los artículos individuales no existen de forma aislada. Un lector que acaba de completar una tarea puede necesitar saber qué hacer a continuación. Un concepto puede depender primero de entender otro concepto. Los enlaces cruzados —cuando se usan deliberadamente— guían a los lectores a través de un camino lógico sin forzar un solo orden de lectura lineal.
Enlaza cuando un lector probablemente necesite el artículo enlazado a continuación, o cuando un término usado en el artículo actual se explica en detalle en otro lugar. No cruces enlaces por el simple hecho de enlazar — el exceso de enlaces distrae y dificulta distinguir qué enlaces importan.
Los enlaces cruzados también forman el grafo de enlaces interno que los motores de búsqueda utilizan para entender qué páginas de tu base de conocimiento son más importantes, y que los sistemas de IA utilizan para navegar entre piezas de información relacionadas al ensamblar una respuesta. Un artículo bien enlazado es más fácil de situar tanto para un humano como para una máquina en contexto.
Gestionar contenido que debe estar en más de un lugar
Algunos artículos realmente sirven a más de un objetivo lector. Un artículo sobre permisos, por ejemplo, podría ser relevante para alguien en "Empezar" y alguien en "Controlando acceso". Si no se resuelve, esto lleva a contenido duplicado (que se descompone) o a una colocación arbitraria que la mitad de tus lectores no encontrarán.
La regla general: un artículo pertenece exactamente a una categoría — su propósito principal — y está enlazado con todas las demás categorías donde los lectores podrían razonablemente buscarlo. No dupliques el contenido en sí. Si ves que la misma información necesita duplicarse para servir bien a dos categorías, eso es una señal de que la información debe dividirse en un artículo compartido al que ambas categorías enlazen.
Estructura y Descubribilidad: SEO, AEO y GEO
La estructura no es solo una cuestión de navegación: afecta directamente a si el contenido puede ser encontrado, tanto por personas como por máquinas.
- Los motores de búsqueda (SEO) utilizan tu jerarquía de navegación, estructura de URL y enlaces internos para entender cómo se relacionan las páginas entre sí y cuánto peso dar a cada una.
- Los motores de respuesta (AEO) prefieren páginas con un propósito claro y singular y una respuesta directamente expresada — que es exactamente lo que el principio de "un tema por artículo" (más abajo) produce de forma natural.
- Los sistemas de IA generativa (GEO) se basan en una estructura consistente y en la intersección para recuperar el artículo correcto y relacionarlo correctamente con temas vecinos, en lugar de fusionar o confundir dos artículos similares.
Una base de conocimiento bien estructurada para la navegación humana está, en la mayoría de los aspectos, ya bien estructurada para estos sistemas. El punto donde esto puede divergir es en la estructura de URL y slug: mantener las URLs estables, descriptivas y alineadas con el tema del artículo, y configurar redirecciones cada vez que un artículo sea renombrado o movido. Los enlaces rotos o redirigidos sin objetivo degradan tanto la experiencia del lector como la capacidad de un rastreador o sistema de IA para confiar en el resto de tu sitio.
Estructura de la base de conocimiento pública vs. privada
La cantidad adecuada de estructura también depende de para quién esté dirigida la base de conocimiento.
- Las bases de conocimiento pública deben acomodar una amplia e impredecible gama de objetivos e entradas de lectores — incluidos los lectores que llegan desde un motor de búsqueda o un asistente de IA directamente a un artículo, sin contexto previo de navegación. La estructura aquí debe funcionar incluso cuando la navegación se omite por completo, por eso el encruzamiento y los artículos autónomos importan más.
- Las bases de conocimiento privadas (internas) suelen servir a un conjunto de objetivos más estrecho y predecible, y a menudo pueden usar una estructura más plana y menos redundante, ya que la audiencia comparte más contexto. Las preocupaciones sobre la descubribilidad pasan de los motores de búsqueda públicos a la búsqueda interna y, si procede, a los asistentes internos de IA — los mismos principios de encabezados claros y estructura coherente siguen aplicándose, solo que sin la capa SEO/AEO.
- Las bases de conocimiento de audiencia mixta — comunes cuando el contenido público y autenticado conviven en el mismo sistema — deberían dejar clara la frontera entre ambos visual y estructuralmente, para que un lector (o rastreador) no tropiece de la documentación pública hacia contenido que asume contexto interno, o viceversa.
Profundidad frente a amplitud
Toda base de conocimiento enfrenta una tensión estructural entre profundidad y amplitud: ¿deberías tener muchos artículos cortos sobre temas concretos, o menos artículos largos que abarquen más temas?
Ninguno de los extremos funciona bien. Los artículos muy cortos fragmentan la información para que los lectores tengan que navegar constantemente solo para lograr una sola tarea. Los artículos muy largos son difíciles de navegar internamente y complicados de mantener al día.
Una heurística útil: cada artículo debe tratar exactamente un tema: el tema implícito por su título. Si el título de un artículo es "Gestión de usuarios", todo lo que contiene ese artículo debería ser relevante para gestionar usuarios. Si te encuentras escribiendo una sección que debería estar en otro artículo, muévela.
Como guía general, la mayoría de las guías prácticas y artículos conceptuales funcionan bien entre 400 y 1.200 palabras. Los artículos de referencia pueden ser más largos por necesidad. Los artículos de solución de problemas suelen ser más cortos y se centran en síntomas específicos.
Planificación para el crecimiento
Una base de conocimiento bien estructurada desde el lanzamiento se volverá mal estructurada si no se planifica el crecimiento. Nuevos artículos añadidos sin hogar crean contenido huérfano. Las nuevas características cubiertas sin una categoría clara crean ambigüedad en la navegación.
Incorpora una pequeña cantidad de estructura hacia adelante en tu diseño inicial. Si estás documentando un producto que tendrá tres nuevas funciones principales en el próximo año, deja espacio en tu navegación para ellas ahora. Es más fácil poblar una categoría vacía que reestructurar una completa.
Establece una cadencia de revisión regular — trimestral es adecuada para la mayoría de las bases de conocimiento — para auditar la estructura de navegación e identificar artículos que se hayan quedado huérfanos, redundantes o obsoletos. Incluir enlaces rotos y redirigidos en esa auditoría; Los cambios estructurales que dejan enlaces muertos socavan silenciosamente tanto la confianza como la descubribilidad del lector con el tiempo.
Un proceso práctico de planificación
Antes de escribir un solo artículo, completa estos seis pasos.
- Haz una lista de tus objetivos de lector. Anota cada tarea que un lector pueda necesitar realizar usando tu base de conocimientos. No filtres — captura todo.
- Agrupa los objetivos. Objetivos relacionados con los clusters juntos. Estos grupos se convertirán en tus categorías principales.
- Nombra las categorías. Escribe los nombres de las categorías desde la perspectiva del lector. Los nombres deben describir lo que el lector encontrará allí, no cómo el equipo de producto llama a esa zona.
- Mapea tu contenido existente. Si trabajas con artículos existentes, asigna cada uno a una categoría dentro de tu nueva estructura. Los artículos que no encajan en ningún sitio pueden necesitar ser reescritos o retirados. Cuando un artículo parezca pertenecer a más de un lugar, decide su categoría principal y planifica los enlaces cruzados con el resto.
- Prueba la estructura con lectores reales. Antes de comprometerte, asigna una tarea a un puñado de lectores y observa dónde la buscan en la navegación propuesta. Si no pueden predecir dónde vive algo, revisa antes de construir.
- Identifica los huecos. Los objetivos de tu lista que no están cubiertos por el contenido existente son tu acumulación de escritura.
Este proceso lleva uno o dos días para una base de conocimientos de tamaño medio. El tiempo que se pasa aquí ahorra semanas de reestructuración después.