- Alerta que a decisão de interromper contratações ou demitir com base na crença de que a IA pode substituir technical writers humanos foi um erro grave
- A documentação gerada por IA não tem inteligência nem empatia e não passa de uma casca vazia incapaz de conter a verdade e o contexto do produto
- Technical writers são profissionais essenciais para tornar um produto compreensível por meio de empatia com o usuário, coleta de informações e comunicação clara
- A "redação técnica ampliada", que combina ferramentas de IA com políticas, é uma alternativa realista para aumentar a produtividade
- A IA cria ruído, mas os humanos criam sinal — pede o retorno e a recontratação de technical writers
O problema da dependência de IA para substituir technical writers
- Demitir technical writers (Technical Writer) ou deixar de contratá-los por causa da IA foi um grande erro
- Confiar apenas em documentação escrita por IA gera resultados sem supervisão especializada nem compreensão de contexto
- Transferir para desenvolvedores o peso de escrever documentação é interpretar mal a própria natureza da documentação
- Documentação técnica não é um simples entregável, mas um componente central que contém a verdade do produto (product truth)
- Software não está finalizado, não é autoevidente e não é simples; por isso, sem documentação ele não pode ser usado
- Technical writers conectam o produto por meio de coleta de informações, expressão clara e narrativa centrada no usuário
Limites da documentação gerada por IA
- A documentação gerada por IA não tem inteligência e carece de visão
- Mesmo treinada com milhões de tokens, ela não consegue definir estratégia documental, estruturar conteúdo nem projetar reutilização
- Não capta situações excepcionais, fronteiras sutis nem a tensão do que ainda está incompleto, deixando o conteúdo vazio
- A responsabilidade legal continua sendo humana, não da IA
- Se orientações incorretas causarem danos, a responsabilidade recai sobre gestores ou empresas
- Não é possível demitir um modelo de IA nem levá-lo ao tribunal; não há como escapar da responsabilidade
- Para gerar documentação, a IA precisa de contexto prévio de alta qualidade (context)
- RAG, regras do Cursor e Claude Skills fazem parte, todos, de uma extensão do trabalho de redação técnica
- Se você demite os redatores, desaparece a própria base de dados da qual a IA aprende
Possibilidades de colaboração entre technical writers e IA
- Ao oferecer ferramentas e treinamento em IA, a produtividade de technical writers pode aumentar bastante
- Com políticas de IA, é possível proteger a qualidade e ao mesmo tempo construir um ambiente de documentação voltado ao futuro, em colaboração com IA
- Já existem casos de technical writers que usam IA para automatizar escrita, edição e publicação
- O CEO da AWS, Matt Garman, também reconheceu ganhos de produtividade no sentido de apoiar humanos, e não substituí-los
- As empresas devem oferecer a technical writers tempo e recursos para definir e experimentar estratégias de IA
- Technical writers já têm capacidade de maximizar eficiência com recursos limitados
- Com as ferramentas e oportunidades adequadas, podem usar IA para elevar a qualidade da documentação
Pedido de recontratação e mudança de percepção
- É preciso abandonar a premissa equivocada de que a IA substituiu completamente o papel humano
- Redação técnica não é mera combinação de palavras; envolve entrevistas com especialistas, entendimento do produto e interpretação de contexto
- Technical writers não são luxo, mas profissionais indispensáveis, atuando como tradutores que tornam o produto utilizável
- Sem eles, o produto não consegue se explicar ou transmite informações falsas
- Conclui afirmando que a IA produz ruído infinito, mas os humanos produzem sinal significativo
- Faz um apelo para trazer de volta os Technical Writers demitidos e voltar a trabalhar com eles
2 comentários
Não é uma questão de IA ou de humanos,
mas sim se é possível ou não ter "empatia com o usuário, coletar informações e transmitir com clareza".
Comentários do Hacker News
Eu sou alguém que trabalha profissionalmente com redação de documentação
Mas, na prática, meu trabalho é observar, ouvir e compreender
Para escrever bem, é preciso entender profundamente a ansiedade e a confusão do leitor
Sempre que uso um sistema de transporte público no exterior, eu reviso o guia local de transporte
Eu melhoro o texto vivenciando diretamente a confusão do ponto de vista do leitor
A empatia é o motor que move o meu trabalho
Ao longo dos anos, construí uma infraestrutura para coletar informações por meio de relações de confiança com pessoas
A IA lida apenas com o que já foi registrado, mas eu saio ao mundo para fazer perguntas
Criei ferramentas para coletar experiências com imigração e entrevistei centenas de advogados e especialistas
A IA depende de dados, mas eu caço meus próprios dados
Acreditar que a IA pode substituir esse trabalho é um mal-entendido ofensivo sobre a profissão
Mesmo que a documentação de transporte público fique péssima, a receita não cai imediatamente
Mas, se você demite o redator técnico, o orçamento cai na hora
Com software é a mesma coisa — as barreiras de entrada são altas, então é difícil dizer “isso é ruim, vou fazer algo melhor”
Código é documentação que o computador lê
Como computadores não têm bom senso, toda compreensão depende do programador
Só porque um LLM produz frases gramaticalmente corretas não significa que ele escreva boa documentação
Do mesmo modo, só porque ele gera código que compila não significa que cria o programa que o usuário quer
Eu expresso a mesma ideia com a frase “tecnologia precisa de alma”
Documentação técnica, UI e produto só ganham valor quando têm sensibilidade humana
A ambição da IA de substituir pessoas é ofensiva
Nós não registramos tudo — justamente as coisas óbvias pelo senso comum não são registradas, mas a IA precisa exatamente desses dados
Eu não trabalho numa empresa que demitiu redatores técnicos, mas a minha empresa passou pela mesma coisa
Como os redatores passaram a depender da IA, o resultado foi terrível, e eles quase não conseguiam escrever por conta própria
É difícil encontrar bons redatores técnicos no mercado, e mesmo com um bom portfólio muitas vezes o trabalho real é péssimo
No fim, a documentação acaba ficando com os desenvolvedores — mas os desenvolvedores não querem isso no currículo
Demitir até mesmo um redator mais ou menos decente é uma forma de arruinar o negócio
A IA é forte em dados com padrão consistente, como README ou config, mas fraca em conteúdo único, como documentação de produto
Há um tipo de documento em que a IA vai bem — aquele que ninguém lê, feito só para compliance
Esses documentos definem apenas termos básicos, como CPU, e deixam de fora justamente os termos importantes do domínio
Estão cheios de referências a documentos inacessíveis, UML que não bate com o código, assinaturas antigas e screenshots desencontradas
O formato também é todo inconsistente, então ninguém lê esse tipo de documento além de um gerente de QA deprimido
Em compensação, se você colocar muitos exemplos concretos, a IA ajuda bem mais
Os melhores redatores técnicos não apenas documentam o produto
Eles agem como usuários reais e encontram problemas de usabilidade
Têm a capacidade de extrair as informações necessárias em entrevistas 1:1 com engenheiros
A IA não desempenha bem esse papel
Mesmo internamente, o feedback de primeira impressão sobre um conteúdo visto pela primeira vez é muito importante
Mas muitas organizações bloqueiam uma cultura de feedback entre departamentos
Como resultado, o conteúdo técnico voltado para marketing muitas vezes fica vago e sem sentido
Isso porque muitos projetos não têm documentação ou têm documentação horrível
É a primeira pessoa a perceber como problema um workflow complexo
Com frequência ele também tem bagagem técnica suficiente para lidar com linguagens como Python
A IA até pode substituir redatores técnicos, mas não é um bom substituto
As empresas com a melhor documentação ainda vão manter redatores humanos
Muita gente acha, por engano, que “qualquer um sabe escrever”, mas na prática não é assim
(Texto relacionado: Nobody Can Write)
Redatores técnicos também contribuem para UX e testes, e são os primeiros a notar inconsistências na nomenclatura de APIs
A IA pode servir como ferramenta auxiliar, mas publicar sem edição é arriscado
Veja esta discussão neste comentário
Os melhores redatores técnicos fazem a ponte entre equipe de produto, engenheiros e usuários como antropólogos
Essa perspectiva ajuda a melhorar o próprio produto
A documentação está sendo empurrada para os desenvolvedores, e só resta a ordem de “façam com IA”
Fico me perguntando se esse é mesmo o futuro prometido
mas não tem sensibilidade para perceber lacunas culturais entre pessoas
Em 2026, quero desenvolver ainda mais minha escrita e minha capacidade de comunicação
Essas habilidades não são facilmente substituíveis
Quando você aprende isso por conta própria, sua forma de pensar muda e isso ajuda em outras áreas da vida
O verdadeiro prejuízo é o desaparecimento do upgrade de habilidades humano
O estilo uniforme dos LLMs cansa rápido
No longo prazo, o ganho de velocidade talvez não compense a perda de habilidade
No começo, o título me confundiu
Achei que fosse “uma carta para redatores demitidos por terem sido pegos usando IA”
O texto inteiro é linguisticamente ambíguo, e isso acabou reduzindo minha confiança em redatores humanos
Eu também me formei em literatura inglesa e ciência da computação, ensinei escrita para alunos de doutorado
e hoje administro diretamente a documentação da empresa
que a segunda interpretação (“para redatores substituídos por IA”) parece mais natural
Há algo a aprender com as seguradoras
Elas usam IA para encontrar razões para negar pedidos legítimos
Nos tribunais, fogem da responsabilidade dizendo que foi “bug de software”
Espero que esse tipo de desculpa não vire padrão
Devemos esperar que os LLMs continuem melhorando no futuro?
Muitos textos tratam as limitações atuais como se fossem permanentes
Ignorar a possibilidade de avanço parece míope
O nível de expectativa varia de pessoa para pessoa