Abra Confluence ahora mismo y busque un documento que necesite leer. ¿Qué ve?
Una barra de herramientas. Botones de edición. Cuadros de comentarios. Enlaces al historial de la página. Una barra lateral llena de navegación que no necesita. Migas de pan. Campos de metadatos. Indicadores de permiso. Toda una interfaz de autoría envuelta alrededor del texto que ha venido a leer.
Ahora piense en lo que realmente quería: la respuesta a una pregunta, o los tres pasos siguientes de un proceso, o una política que necesita consultar antes de una reunión dentro de diez minutos.
Usted vino a consumir. La interfaz supuso que usted había venido a crear.
Esto es lo predeterminado en casi todas las plataformas de documentación. Confluence, Notion, SharePoint, GitBook, Nuclino, Slite. Todas ellas presentan el mismo entorno a lectores y escritores. La página es la página. Todo el mundo tiene la misma vista, más o menos unos cuantos botones con permisos.
Parece normal porque nunca hemos tenido otra cosa. Pero es una decisión de diseño, no una ley de la naturaleza. Y es la equivocada.
La misma interfaz para leer y escribir crea una sobrecarga cognitiva](/es/blog/img/readers-writers-ui.svg)
Leer y escribir no son la misma tarea cognitiva
No se trata de una preferencia de interfaz de usuario. Es una diferencia fundamental en el funcionamiento del cerebro.
Cuando escribe, está en modo generativo. Está construyendo, organizando, decidiendo qué incluir y qué omitir. Necesita herramientas: opciones de formato, controles de estructura, incrustación de medios, campos de metadatos, historial de versiones, funciones de colaboración. La interfaz debe proporcionarle potencia y flexibilidad.
Cuando lee, está en modo receptivo. Está escaneando, filtrando, extrayendo lo que es relevante y tratando de seguir adelante. Necesita claridad: tipografía limpia, diseño centrado, distracciones mínimas. La interfaz debe apartarse de su camino.
La psicología cognitiva tiene un marco claro para esto. La Teoría de la carga cognitiva, desarrollada por John Sweller a finales de la década de 1980, distingue entre carga intrínseca (la dificultad del material en sí), carga germana (el esfuerzo de aprender e integrar) y carga extraña (todo lo que el entorno añade que no ayuda). Cada barra de herramientas, barra lateral y botón de edición visible para un lector es carga extraña. No les ayuda a comprender el contenido. Compite activamente por la atención.
Las investigaciones de Mayer y Moreno (2003) sobre el aprendizaje multimedia demostraron que la reducción de los elementos extraños mejora tanto la comprensión como la retención. Su principio de coherencia es directo: la gente aprende mejor cuando se excluye el material extraño en lugar de incluirlo. Una interfaz de documentación que muestre controles de autoría a los lectores está violando este principio en cada carga de página.
El lector no necesita ver las herramientas del escritor. Mostrarlas de todos modos no es neutral. Es activamente perjudicial para la comprensión.
Cómo manejan esto las plataformas actuales (en su mayoría no lo hacen)
Veamos lo que existe.
Confluence tiene un modo de lectura y un modo de edición, pero el modo de lectura sigue rodeado por la navegación, los metadatos y el árbol de páginas de la plataforma. La barra de herramientas de edición desaparece cuando no se está editando, pero el marco mental de "esta es una página wiki editable" nunca desaparece del todo. Todos los lectores ven el botón "Editar". La página susurra: puedes cambiar esto.
Notion es peor en este sentido. Su filosofía central de diseño es que todo es siempre editable. Haga clic en cualquier sitio y estará escribiendo. Eso es brillante para los escritores. Es terrible para los lectores que sólo quieren absorber el contenido sin la ansiedad de modificar algo accidentalmente. La propia [galería de plantillas] de Notion (https://www.notion.com/templates) lo demuestra: cada plantilla es un espacio de trabajo, no una publicación.
SharePoint admite técnicamente distintos diseños de página para la visualización y la edición, pero la experiencia general sigue siendo la de una intranet corporativa. Los lectores se sienten como si estuvieran dentro de una herramienta empresarial, no leyendo un documento optimizado para su comprensión.
GitBook es lo que más se acerca a una experiencia de lectura en primer lugar, con su salida limpia al estilo de la documentación. Pero incluso allí, la experiencia del lector sirve a la suposición de que el lector es un desarrollador mirando documentos técnicos. No está diseñado para el consumidor de conocimientos generales.
Ninguna de estas plataformas trata la lectura como una actividad fundamentalmente diferente de la escritura. La tratan como escribir con la barra de herramientas oculta.
Herramientas actuales: una interfaz, todos los públicos](/es/blog/img/readers-writers-current-tools.svg)
El coste de una interfaz única
No se trata sólo de un problema estético. Tiene consecuencias cuantificables.
La sobrecarga de información reduce la comprensión
Un estudio publicado en el Journal of Consumer Research descubrió que la sobrecarga de información conduce a una peor calidad de la decisión, y que el efecto aumenta a medida que crece la proporción entre información irrelevante y relevante. Una página de documentación con controles de autor visibles, árboles de navegación y campos de metadatos aumenta esa proporción para cada lector que no está allí para escribir.
El cambio de contexto tiene un coste real
Cuando una señal de la interfaz dice "puede editar esto", activa un marco cognitivo diferente al de "lea esto". La investigación de Gloria Mark en la UC Irvine sobre la atención y la multitarea descubrió que se tarda una media de 23 minutos y 15 segundos en volver a centrarse completamente tras un cambio de contexto. Un lector que se plantea momentáneamente editar (aunque sea para corregir una errata) ha sido sacado del modo lectura. No es una hipótesis. Cualquiera que haya utilizado Notion conoce la experiencia de hacer clic para seleccionar texto y empezar a escribir accidentalmente.
Los lectores y los escritores tienen necesidades diferentes ante el mismo contenido
Un escritor necesita ver la estructura, los marcadores de formato, los tipos de bloque, los metadatos y las señales de colaboración. Necesitan toda la maquinaria.
Un lector necesita ver un texto limpio, una jerarquía clara y el camino más rápido hacia la información que busca. Necesitan el contenido, no la maquinaria.
Servir a ambos desde la misma interfaz significa que ninguno obtiene una experiencia optimizada para lo que realmente está haciendo.
Y luego está el tercer público: AI
Aquí es donde la cosa se complica, y donde las plataformas existentes no están en absoluto preparadas.
La documentación en 2026 tiene tres consumidores distintos, no dos:
- Escritores que crean y mantienen el contenido
- Lectores que consumen contenidos visualmente
- Sistemas de inteligencia artificial que recuperan, analizan y sintetizan contenidos mediante programación
Cada uno de estos públicos necesita una interfaz fundamentalmente diferente para el mismo contenido subyacente.
Los escritores necesitan herramientas de edición enriquecidas, funciones de colaboración y controles estructurales. Los lectores necesitan una presentación limpia y centrada con un mínimo de distracciones. La IA necesita una salida estructurada y legible por máquina con metadatos explícitos: señales de frescura, etiquetas de clasificación, direccionamiento a nivel de bloque y un marcado semántico limpio.
Como ya comentamos en Builders, Not Developers, los intermediarios de la IA ya son el consumidor dominante de documentación para una parte cada vez mayor de los trabajadores del conocimiento. La encuesta de desarrolladores 2024 de GitHub descubrió que el 97% de los desarrolladores empresariales han utilizado herramientas de codificación de IA. Para 2026, el 84% de los desarrolladores utilizarán herramientas de IA con regularidad, y el 41% de todo el código será generado por IA.
A estos sistemas de IA no les importa su barra lateral ni su barra de herramientas. Necesitan datos limpios. Y una plataforma que confunde la vista del lector con la del escritor también está confundiendo la superficie consumible por la IA con la superficie de autoría humana. Son tres desajustes en una sola interfaz.
Cómo separa Rasepi las experiencias
Rasepi se basa en el principio de que crear contenidos y consumirlos son actividades distintas que merecen interfaces diferentes.
El entorno del escritor
Cuando escribe en Rasepi, dispone de un entorno de autor completo. Edición de texto enriquecido con TipTap, controles a nivel de bloque, indicadores de estado de traducción, gestión de vencimientos, herramientas de colaboración, vistas de estructura de contenidos y todo lo que un escritor necesita para crear y mantener una documentación de alta calidad.
El redactor ve la maquinaria porque necesita la maquinaria.
El entorno del lector
Cuando alguien consume un documento Rasepi, ve una experiencia de lectura limpia y centrada. Sin cromo de edición. Sin barras de herramientas. Sin señales de "usted podría modificar esto". Sólo el contenido, presentado en un diseño optimizado para la comprensión y el escaneado.
El lector no ve el botón de edición porque no está aquí para editar. Están aquí para aprender algo, seguir un proceso o encontrar una respuesta. La interfaz respeta esa intención.
La superficie AI
Para los consumidores de IA, Rasepi expone el contenido a través de API estructuradas con metadatos completos. Cada bloque lleva su puntuación de frescura, estado de traducción, hash del contenido y etiquetas de clasificación. Los sistemas de IA pueden consultar el contenido a nivel de bloque, filtrar por frescura, excluir el material obsoleto o borrador y recuperar exactamente los datos estructurados que necesitan.
Nada de raspar una página wiki y esperar lo mejor. La IA dispone de una interfaz especialmente diseñada, al igual que el lector y el escritor.
Una capa de contenido, tres interfaces
Lo importante es que no estamos manteniendo tres copias del contenido. Este no es el problema de las cinco copias del mismo documento que comentamos en Deje de mantener cinco copias del mismo documento.
Se trata de una capa de contenido, almacenada como bloques estructurados, servida a través de tres vistas diferentes optimizadas para tres públicos distintos.
El escritor edita bloques. El lector ve el contenido ensamblado y estilizado. La IA consulta datos estructurados con metadatos. Los mismos bloques. La misma fuente de verdad. Diferente capa de presentación para cada consumidor.
Esto sólo es posible gracias a la arquitectura a nivel de bloque. Cada pieza de contenido es una unidad direccionable individualmente con sus propios metadatos. Puede presentar esos bloques de forma diferente en función de quién los solicite:
| Audiencia | Necesidades | Obtiene |
|---|---|---|
| Escritor | Formateo, estructura, colaboración, metadatos | Entorno de autor completo con controles a nivel de bloque |
| Lector | Texto limpio, jerarquía clara, escaneo rápido | Vista de lectura centrada, sin cromo de edición |
| AI | Datos estructurados, puntuaciones de frescura, clasificación | API a nivel de bloque con metadatos completos |
Por qué esto importa más de lo que parece
Puede que lea esto y piense: "Es sólo interfaz de usuario. Diferentes vistas de la misma cosa. ¿Qué importancia puede tener?"
Resulta que es muy importante.
Confianza de los lectores
La gente confía en los contenidos que parecen publicados. Cuando una página parece un wiki que cualquiera puede editar, los lectores la descartan inconscientemente. Cuando el mismo contenido se presenta en una vista de lectura limpia y con calidad de publicación, conlleva más autoridad. Esto no es irracional. Es una señal de que alguien se tomó en serio la presentación, lo que implica que también se tomó en serio el contenido.
El Grupo Nielsen Norman ha estudiado este tema en profundidad. Su investigación sobre la credibilidad del contenido muestra que la calidad del diseño y la presentación se encuentran entre las señales más fuertes en las que se basan los usuarios para evaluar la fiabilidad del contenido. Una vista de editor desordenada socava activamente la credibilidad del contenido que muestra.
Productividad del redactor
Los escritores que trabajan en un entorno de autor dedicado no tienen que cambiar de contexto entre "¿estoy leyendo o estoy escribiendo?". Las herramientas están ahí porque se supone que tienen que estar ahí, no porque la interfaz no pueda decidir quién la está mirando.
Fiabilidad de la IA
Cuando los sistemas de IA disponen de una superficie construida a propósito con metadatos estructurados, pueden tomar mejores decisiones sobre qué recuperar y qué excluir. Pueden comprobar las puntuaciones de frescura antes de incluir un bloque en una respuesta. Pueden respetar las etiquetas de clasificación. Pueden filtrar por idioma, estado o audiencia. Nada de eso es posible cuando la IA está raspando la misma página HTML que se diseñó para lectores humanos.
El cambio de modelo mental
El supuesto fundamental de la mayoría de las plataformas de documentación es: la página es la unidad, y todo el mundo interactúa con la página.
La suposición de Rasepi es diferente: el bloque es la unidad, y distintos públicos interactúan con los bloques a través de superficies creadas a tal efecto.
Parece una pequeña distinción arquitectónica. No lo es. Es la diferencia entre una herramienta que accidentalmente muestra contenidos a los sistemas de inteligencia artificial y otra que deliberadamente les sirve. Entre un entorno de escritura que resulta ser legible y una experiencia de lectura diseñada desde cero. Entre una interfaz suficientemente buena y tres excelentes.
La documentación ya no sólo se escribe y se lee. Se escribe, se lee, se consulta, se traduce, se puntúa, se clasifica y se sirve a sistemas de IA a escala. Una única interfaz no puede optimizar todo eso, y fingir que puede es la forma en que acabamos con wikis que nadie quiere leer y asistentes de IA que extraen respuestas de páginas que nunca fueron diseñadas para ser consumidas por máquinas.
Los lectores y los escritores están en modos mentales diferentes. La IA está en un modo completamente diferente. La interfaz debería reflejarlo.