Abra o Confluence agora mesmo e encontre um documento que precise de ler. O que é que vê?
Uma barra de ferramentas. Botões de edição. Caixas de comentários. Ligações para o histórico da página. Uma barra lateral cheia de navegação de que não precisa. Pistas de navegação. Campos de metadados. Indicadores de permissão. Toda uma interface de criação em torno do texto que veio aqui para ler.
Agora pense no que realmente queria: a resposta a uma pergunta, ou os três passos seguintes de um processo, ou uma política que precisa de consultar antes de uma reunião daqui a dez minutos.
Veio para consumir. A interface pressupõe que veio para criar.
Este é o padrão em quase todas as plataformas de documentação. Confluence, Notion, SharePoint, GitBook, Nuclino, Slite. Todas elas apresentam o mesmo ambiente aos leitores e escritores. A página é a página. Toda a gente tem a mesma visão, com mais ou menos alguns botões com permissões.
Parece normal porque nunca tivemos outra coisa. Mas é uma decisão de design, não uma lei da natureza. E é a decisão errada.
Ler e escrever não são a mesma tarefa cognitiva
Isto não é uma preferência de interface. Trata-se de uma diferença fundamental na forma como o cérebro funciona.
Quando se escreve, está-se em modo generativo. Está a construir, a organizar, a decidir o que incluir e o que deixar de fora. Precisa de ferramentas: opções de formatação, controlos de estrutura, incorporação de suportes, campos de metadados, histórico de versões, funcionalidades de colaboração. A interface deve proporcionar-lhe poder e flexibilidade.
Quando se lê, está-se em modo recetivo. Está a analisar, a filtrar, a extrair o que é relevante e a tentar seguir em frente. Necessita de clareza: tipografia limpa, disposição clara, distração mínima. A interface deve sair do caminho.
A psicologia cognitiva tem uma estrutura clara para isto. A [Teoria da Carga Cognitiva] (https://www.instructionaldesign.org/theories/cognitive-load/), desenvolvida por John Sweller no final dos anos 80, distingue entre carga intrínseca (a dificuldade do material em si), carga germânica (o esforço de aprendizagem e integração) e carga externa (tudo o que o ambiente acrescenta que não ajuda). Todas as barras de ferramentas, barras laterais e botões de edição visíveis para um leitor são cargas estranhas. Não os ajuda a compreender o conteúdo. Concorre ativamente pela atenção.
A investigação de [Mayer e Moreno (2003)] (https://doi.org/10.1207/S15326985EP3801_6) sobre a aprendizagem multimédia demonstrou que a redução de elementos estranhos melhora a compreensão e a retenção. O seu princípio de coerência é direto: Uma interface de documentação que mostra os controlos de criação aos leitores está a violar este princípio em cada carregamento de página.
**O leitor não precisa de ver as ferramentas do autor. Mostrá-las na mesma não é neutro. É ativamente prejudicial para a compreensão.
Como é que as plataformas actuais lidam com isto (a maioria não lida)
Vejamos o que existe.
O Confluence tem um modo de leitura e um modo de edição, mas o modo de leitura ainda está rodeado pela navegação, metadados e árvore de páginas da plataforma. A barra de ferramentas de edição desaparece quando não se está a editar, mas o quadro mental de "esta é uma página wiki editável" nunca desaparece completamente. Todos os leitores vêem o botão "Editar". A página sussurra: podes mudar isto.
O Notion é pior neste aspeto. A sua principal filosofia de design é que tudo é sempre editável. Clique em qualquer lugar e está a escrever. Isso é ótimo para os escritores. É terrível para os leitores que querem apenas absorver o conteúdo sem a ansiedade de modificar algo acidentalmente. A própria [galeria de modelos] do Notion (https://www.notion.com/templates) mostra isso: cada modelo é um espaço de trabalho, não uma publicação.
O SharePoint suporta tecnicamente diferentes layouts de página para visualização e edição, mas a experiência geral continua a ser uma intranet corporativa. Os leitores sentem-se como se estivessem dentro de uma ferramenta empresarial e não a ler um documento optimizado para a compreensão.
O GitBook é o que mais se aproxima de uma experiência de leitura em primeiro lugar, com a sua saída limpa ao estilo de documentação. Mas mesmo aí, a experiência de leitura serve o pressuposto de que o leitor é um programador que está a olhar para documentos técnicos. Não foi concebido para o consumidor de conhecimentos gerais.
Nenhuma destas plataformas trata a leitura como uma atividade fundamentalmente diferente da escrita. Tratam-na como escrever com a barra de ferramentas escondida.
Ferramentas actuais: uma interface, todos os públicos](/pt/blog/img/leitores-escritores-ferramentas-actuais.svg)
O custo de uma interface única
Este não é apenas um problema estético. Tem consequências mensuráveis.
A sobrecarga de informação reduz a compreensão
Um [estudo publicado no Journal of Consumer Research] (https://doi.org/10.1086/209336) descobriu que a sobrecarga de informação leva a uma pior qualidade de decisão, com o efeito a aumentar à medida que o rácio entre informação irrelevante e relevante cresce. Uma página de documentação com controlos de criação visíveis, árvores de navegação e campos de metadados aumenta esse rácio para todos os leitores que não estão lá para escrever.
A mudança de contexto tem um custo real
Quando um sinal de interface diz "pode editar isto", ativa um quadro cognitivo diferente de "leia isto". A investigação de Gloria Mark na UC Irvine sobre atenção e multitarefas concluiu que são necessários, em média, 23 minutos e 15 segundos para voltar a concentrar-se totalmente após uma mudança de contexto. Um leitor que considere momentaneamente a hipótese de editar (mesmo para corrigir uma gralha) foi retirado do modo de leitura. Não se trata de uma hipótese. Qualquer pessoa que tenha utilizado o Notion conhece a experiência de clicar para selecionar texto e acidentalmente começar a escrever.
Leitores e escritores têm necessidades diferentes para o mesmo conteúdo
Um escritor precisa de ver a estrutura, os marcadores de formatação, os tipos de blocos, os metadados e os sinais de colaboração. Precisa de toda a maquinaria.
Um leitor precisa de ver texto limpo, hierarquia clara e o caminho mais rápido para a informação que procura. Precisa do conteúdo, não da maquinaria.
Servir ambos a partir da mesma interface significa que nenhum deles obtém uma experiência optimizada para o que estão realmente a fazer.
E depois há o terceiro público: A IA
É aqui que tudo se complica e que as plataformas existentes não estão preparadas.
A documentação em 2026 tem três consumidores distintos, não dois:
- Escritores que criam e mantêm conteúdos
- Leitores que consomem conteúdos visualmente
- Sistemas de IA que recuperam, analisam e sintetizam conteúdos de forma programática
Cada um destes públicos necessita de uma interface fundamentalmente diferente para o mesmo conteúdo subjacente.
Os escritores precisam de ferramentas de edição ricas, funcionalidades de colaboração e controlos estruturais. Os leitores precisam de uma apresentação clara e concentrada, com o mínimo de distracções. A IA necessita de resultados estruturados e analisáveis por máquina com metadados explícitos: sinais de atualidade, etiquetas de classificação, endereçamento ao nível do bloco e marcação semântica clara.
Como discutimos em Builders, Not Developers, os intermediários de IA já são o consumidor dominante de documentação para uma parte crescente dos trabalhadores do conhecimento. A pesquisa de desenvolvedores do GitHub de 2024 descobriu que 97% dos desenvolvedores corporativos usaram ferramentas de codificação de IA. Em 2026, [84% dos programadores utilizam regularmente ferramentas de IA] (https://www.index.dev/blog/developer-productivity-statistics-with-ai-tools), sendo que 41% de todo o código é gerado por IA.
Estes sistemas de IA não querem saber da sua barra lateral ou da sua barra de ferramentas. Eles precisam de dados limpos. E uma plataforma que confunde a visão do leitor com a visão do escritor também está a confundir a superfície consumível pela IA com a superfície de criação humana. São três incompatibilidades numa só interface.
Três públicos, três necessidades diferentes] (/blog/img/leitores-escritores-três-audiências.svg)
Como o Rasepi separa as experiências
O Rasepi foi concebido com base no princípio de que criar conteúdos e consumir conteúdos são actividades diferentes que merecem interfaces diferentes.
O ambiente do escritor
Quando está a escrever no Rasepi, obtém um ambiente de criação completo. Edição de texto rico com TipTap, controlos ao nível do bloco, indicadores de estado da tradução, gestão de expiração, ferramentas de colaboração, vistas da estrutura de conteúdos e tudo o que um escritor precisa para criar e manter documentação de alta qualidade.
O escritor vê a maquinaria porque precisa da maquinaria.
O ambiente do leitor
Quando alguém consome um documento Rasepi, vê uma experiência de leitura limpa e focada. Sem chrome de edição. Sem barras de ferramentas. Sem sinais de "pode modificar isto". Apenas o conteúdo, apresentado num esquema optimizado para compreensão e leitura.
O leitor não vê o botão de edição porque não está aqui para editar. Está aqui para aprender algo, seguir um processo ou encontrar uma resposta. A interface respeita essa intenção.
A superfície da IA
Para os consumidores de IA, o Rasepi expõe o conteúdo através de APIs estruturadas com metadados completos. Cada bloco tem a sua pontuação de frescura, estado de tradução, hash de conteúdo e etiquetas de classificação. Os sistemas de IA podem consultar o conteúdo ao nível do bloco, filtrar por frescura, excluir material obsoleto ou de rascunho e obter exatamente os dados estruturados de que necessitam.
Não é preciso raspar uma página wiki e esperar pelo melhor. A IA obtém uma interface criada para o efeito, tal como o leitor e o escritor.
Uma camada de conteúdo, três interfaces
O importante é que não estamos a manter três cópias do conteúdo. Este não é o problema das cinco cópias de integração que discutimos em [Stop Maintaining Five Copies of the Same Document] (/blog/stop-maintaining-five-copies-of-the-same-document/).
Trata-se de uma camada de conteúdo, armazenada como blocos estruturados, servida através de três vistas diferentes optimizadas para três públicos diferentes.
O redator edita os blocos. O leitor vê o conteúdo montado e estilizado. A IA consulta dados estruturados com metadados. Os mesmos blocos. A mesma fonte de verdade. Camada de apresentação diferente para cada consumidor.
Isto só é possível devido à arquitetura ao nível dos blocos. Cada conteúdo é uma unidade individualizável com os seus próprios metadados. Pode apresentar esses blocos de forma diferente, dependendo de quem os está a pedir:
| Audiência | Necessidades | Obtém |
|---|---|---|
| Ambiente de criação completo com controlos ao nível dos blocos | ||
| Leitor** | Texto limpo, hierarquia clara, digitalização rápida | Vista de leitura focada, sem cromo de edição |
| API a nível de bloco com metadados completos |
Porque é que isto é mais importante do que parece
Poderá ler isto e pensar: "É apenas a interface do utilizador. Vistas diferentes da mesma coisa. Quão importante pode ser?"
Muito importante, ao que parece.
Confiança do leitor
As pessoas confiam em conteúdos que parecem publicados. Quando uma página parece um wiki que qualquer pessoa pode editar, os leitores inconscientemente desconfiam dela. Quando o mesmo conteúdo é apresentado numa visualização de leitura limpa e com qualidade de publicação, tem mais autoridade. Isto não é irracional. É um sinal de que alguém levou a apresentação a sério, o que implica que também levou o conteúdo a sério.
O Nielsen Norman Group estudou extensivamente esta questão. A sua [investigação sobre a credibilidade do conteúdo] (https://www.nngroup.com/articles/trust-signals-content/) mostra que a qualidade do design e a apresentação são dos sinais mais fortes em que os utilizadores confiam para avaliar a fiabilidade do conteúdo. Uma vista de editor desordenada prejudica ativamente a credibilidade do conteúdo que apresenta.
Produtividade do escritor
Os escritores que trabalham num ambiente de criação dedicado não têm de alternar entre "estou a ler ou estou a escrever?". As ferramentas estão lá porque é suposto estarem lá, não porque a interface não consegue decidir quem está a olhar para ela.
Fiabilidade da IA
Quando os sistemas de IA têm uma superfície criada para o efeito com metadados estruturados, podem tomar melhores decisões sobre o que recuperar e o que excluir. Podem verificar as pontuações de atualidade antes de incluir um bloco numa resposta. Podem respeitar as etiquetas de classificação. Podem filtrar por idioma, estado ou público. Nada disto é possível quando a IA está a extrair a mesma página HTML que foi concebida para leitores humanos.
A mudança de modelo mental
O pressuposto fundamental da maioria das plataformas de documentação é: a página é a unidade, e toda a gente interage com a página.
O pressuposto do Rasepi é diferente: O pressuposto do Rasepi é diferente: o bloco é a unidade, e diferentes públicos interagem com os blocos através de superfícies criadas para o efeito.
Isto parece uma pequena distinção arquitetónica. Mas não é. É a diferença entre uma ferramenta que mostra acidentalmente conteúdos a sistemas de IA e uma que os serve deliberadamente. Entre um ambiente de escrita que por acaso é legível e uma experiência de leitura que foi concebida de raiz. Entre uma interface suficientemente boa e três excelentes.
A documentação já não é apenas escrita e lida. É escrita, lida, consultada, traduzida, pontuada, classificada e fornecida a sistemas de IA em grande escala. Uma única interface não pode otimizar tudo isso, e fingir que pode é a razão pela qual acabámos com wikis que ninguém quer ler e assistentes de IA a extrair respostas de páginas que nunca foram concebidas para serem consumidas por máquinas.
Os leitores e os escritores estão em modos mentais diferentes. A IA está num modo completamente diferente. A interface deve refletir isso mesmo.