Cada decisión documental — qué incluir, cuánto explicar, qué palabras usar — proviene de una única fuente: una comprensión clara de para quién escribes. Sin ella, estás adivinando. Con él, tienes un filtro fiable para cada elección que tomas.
Tu audiencia hoy es más amplia que antes. Sigue incluyendo al lector humano intentando hacer algo, pero ahora también incluye motores de búsqueda, respuestas y asistentes de IA que leen tu documentación en nombre de esa persona — y a veces le dan una respuesta sin enviarla nunca al artículo. Una definición completa de audiencia tiene en cuenta ambos.
Este artículo explica cómo identificar y describir a tu audiencia, y cómo utilizar ese conocimiento para redactar documentación que sea realmente útil para las personas —y sistemas— que la necesitan.
Por qué importa la definición de audiencia
El mismo tema puede documentarse de formas completamente distintas dependiendo de quién lea. Un artículo sobre cómo configurar permisos de usuario, por ejemplo, se ve muy diferente cuando se escribe para un administrador de sistemas frente a un usuario primerizo. El administrador necesita precisión y casos límite. El usuario primerizo necesita contexto, tranquilidad y pasos claros.
Escribir para "todos" casi siempre significa no escribir para nadie, bueno. Cuando intentas atender a todos los posibles lectores en un solo artículo, acabas abrumando a los principiantes con detalles o aburriendo a expertos con explicaciones que no necesitan.
Cómo describir a tu audiencia
Una descripción útil de la audiencia responde a cuatro preguntas.
¿Qué sabe ya tu lector?
Identifica el conocimiento básico que tu lector aporta al artículo. Esto determina cuánto necesitas explicar y qué términos puedes usar sin definición.
Un lector sin experiencia en tu campo necesita términos definidos, conceptos introducidos y pasos detallados. Un lector que trabaja en el campo a diario no necesita nada de eso: necesita información precisa y eficiente que respete su experiencia.
Sé específico. "Usuarios técnicos" no es útil. "Desarrolladores de software familiarizados con las APIs REST pero nuevos en los flujos de autenticación" lo es.
¿Qué intenta lograr tu lector?
Los lectores llegan a la documentación con un objetivo. Quieren completar una tarea, resolver un problema o entender un concepto. Entender su objetivo te dice qué información debe estar en el artículo y qué es ruido.
Pregunta: ¿cómo se ve el éxito para este lector? Cuando cierren este artículo, ¿qué deberían ser capaces de hacer que antes no podían hacer?
¿En qué contexto está tu lector?
El contexto influye en cómo leen los lectores. Un lector que está en medio de una sesión frustrada de resolución de problemas lee diferente a alguien que explora una función por curiosidad. Un lector en un dispositivo móvil en una reunión lee de forma diferente a alguien en un escritorio con dos monitores.
El contexto te dice cuánta paciencia tiene tu lector, cuántos detalles puede absorber y cuán urgentemente necesita una respuesta.
¿Qué es lo que tu lector no sabe que necesita saber?
Esta suele ser la pregunta más importante y la más difícil de responder. Las lagunas en el conocimiento del lector no siempre son evidentes — especialmente cuando tú mismo eres un experto en el tema. Esta es la "maldición del conocimiento": cuanto más sabes sobre algo, más difícil es recordar cómo era no conocerlo.
Combate esto involucrando a lectores reales en tu proceso de documentación. Las pruebas de usuario, el análisis de tickets de soporte y las conversaciones directas con los clientes son formas efectivas de descubrir lo que la gente realmente no sabe.
Niveles de audiencia por experiencia
La mayoría de las bases de conocimiento sirven a más de un público. Un patrón común es tener tres grupos de lectores distintos, cada uno con un enfoque diferente.
Principiantes
Los principiantes no están familiarizados con el producto, el dominio o ambos. Necesitan orientación antes de la instrucción. Se benefician de una visión general conceptual que explica qué es algo antes de explicar cómo usarlo. Necesitan los requisitos previos especificados, los pasos numerados claramente y los resultados explícitos para saber cuándo han tenido éxito.
Los principiantes se desaniman fácilmente con jerga inexplicada, pasos que se saltan o artículos que asumen contexto que no tienen. Toda suposición inexplicada es un posible punto de salida.
Usuarios intermedios
Los usuarios intermedios conocen lo básico y están ampliando su uso del producto. No necesitan que les acompañen de la mano, pero sí necesitan información completa. A menudo son el grupo más grande en una base de conocimiento y los más difíciles de escribir para ellos, porque sus necesidades son las más variadas.
Los usuarios intermedios se benefician de contenido claro y directo centrado en tareas que va al grano rápidamente y proporciona suficiente contexto para entender el porqué detrás de cada paso.
Usuarios avanzados
Los usuarios avanzados — administradores, desarrolladores, usuarios avanzados — conocen profundamente el producto y necesitan información precisa y detallada. A menudo exploran casos límite, se integran con otros sistemas o resuelven problemas complejos.
Los usuarios avanzados se frustran por la sobreexplicación y los preámbulos innecesarios. Quieren precisión técnica, referencias completas de parámetros y un reconocimiento honesto de las limitaciones. Tolerarán la densidad si eso significa precisión.
Niveles de audiencia por visibilidad
Además de la experiencia, la audiencia también varía según quién puede ver el contenido. Esto afecta no solo al tono, sino también a la estructura, la profundidad y si la búsqueda y la descubribilidad de la IA siquiera se aplican.
Documentación pública
La documentación pública está disponible para cualquiera, incluidas personas que aún no son clientes. Debe funcionar para lectores que llegan sin ningún contexto, y debe ser descubrible — lo que significa que SEO, AEO y GEO se aplican directamente:
- SEO: el artículo debe posicionarse según los términos que buscaría un usuario potencial o actual.
- AEO: el artículo necesita una respuesta clara y extractable cerca del principio, ya que puede mostrarse como un fragmento o leerlo en voz alta por un asistente de voz antes de que el lector haga clic.
- GEO: el artículo debe estar estructurado para que un asistente de IA pueda recuperarlo y citarlo con precisión cuando un usuario le hace la misma pregunta a un chatbot de propósito general.
El contenido público debe asumir el mayor rango posible de conocimientos previos y nunca debe depender de la terminología interna.
Documentación privada (interna)
La documentación privada está restringida a empleados, socios o a una audiencia interna definida. Puede asumir con seguridad un contexto compartido, vocabulario interno y formación previa — lo que le permite ser más denso y eficiente. La descubribilidad aquí se basa en la búsqueda interna, no en los motores de búsqueda públicos: el SEO y la GEO para sistemas públicos de IA son irrelevantes, pero los asistentes internos de IA (si tu organización los utiliza) siguen beneficiándose de la misma estructura clara y terminología coherente que ayuda a la geometría pública.
La documentación privada puede permitirse saltarse la orientación que necesita el contenido público, pero no debería pasar por alto la precisión — una audiencia interna bajo presión de tiempo sigue siendo una audiencia que necesita tener éxito en la primera lectura.
Documentación para audiencias mixtas
Parte del contenido —páginas de precios, resúmenes de seguridad, guías de integración— está escrito para un público mixto: parte público, parte cliente autenticado, a veces parte interno. Este es el nivel más difícil para escribir, porque el mismo artículo puede necesitar satisfacer a un posible cliente que investiga el producto, a un cliente existente configurándolo y a un agente de soporte que lo soluciona problemas.
Para audiencias mixtas, empieza con lo que necesita el grupo más amplio (normalmente el "¿qué es esto y por qué lo usaría yo") y añade cada vez más detalles específicos para los grupos más reducidos, en lugar de intentar promediar el contenido en algo demasiado vago para cualquiera.
Escribiendo para múltiples públicos
Cuando un solo artículo debe servir a más de una audiencia, estructurarlo para que cada grupo —humano o IA— pueda encontrar lo que necesita sin tener que sumergirse en contenido que no es para ellos.
Un enfoque eficaz es empezar con la información esencial que todos los lectores necesitan y luego añadir información progresivamente más detallada. Los principiantes paran cuando tienen lo que necesitan; Los usuarios avanzados continúan con el detalle. Esta superposición también es precisamente lo que beneficia a AEO y GEO: una respuesta clara desde el principio para la extracción, y detalles de apoyo a continuación para los lectores que la quieran.
Otro enfoque es separar completamente el contenido: mantener una versión orientada a principiantes y una versión avanzada del mismo tema. Esto cuesta más mantenerlo, pero produce resultados más satisfactorios para ambos públicos.
Lo que no funciona es intentar servir a cada público en un solo bloque de texto indiferenciado. Cuando todos son la audiencia, nadie lo es — y un sistema de IA que resume un artículo indiferenciado tiene la misma probabilidad de producir una respuesta indiscriminada e inútil.
No olvides el lector de IA
Cada vez más, una parte real de tu audiencia nunca lee el artículo directamente. Le hacen una pregunta a un motor de búsqueda, a un asistente de IA o a un chatbot dentro del producto, y ese sistema lee tu documentación, extrae una respuesta y la presenta en tu nombre. Este "lector" tiene características propias que merece la pena diseñar:
- No tiene paciencia para pistas ocultas — necesita la respuesta cerca del principio del artículo, claramente expresada.
- No tolera la ambigüedad — pronombres vagos, suposiciones no expresadas y terminología inconsistente aumentan las probabilidades de un resumen incorrecto o distorsionado.
- No puede plantear una pregunta de seguimiento como un humano — por lo que la completitud dentro de una sola sección importa más, no menos.
Diseñar para este público no entra en conflicto con diseñar para lectores humanos: las prácticas que hacen que un artículo sea claro y bien estructurado para una persona (una respuesta directa desde el principio, una idea por sección, términos consistentes) son las mismas que facilitan que un sistema de IA recupere y cite correctamente.
Documentando las decisiones de tu audiencia
Las definiciones de audiencia solo son útiles si se comparten. Anota quién es tu público principal para cada sección o tipo de contenido en tu base de conocimiento — incluyendo su nivel de experiencia, su nivel de visibilidad (público, privado o mixto) y si necesita optimizarse para la descubribilidad pública — y pon esa definición a disposición de todos los que contribuyan. Cuando un nuevo escritor se une, debería poder leer la definición de audiencia y entender inmediatamente para quién escribe.
Revisa periódicamente las definiciones de audiencia. A medida que tu producto crece y tu base de usuarios cambia, las personas —y los sistemas— que leen tu documentación también cambian.