Redator técnico / engenheiro de documentação

Entrevistas semiestruturadas a 31 redatores técnicos experientes em startups, grandes empresas e projetos de código aberto. Os autores descrevem cinco fases de revisão: 28 participantes descreveram a revisão técnica feita por engenheiros ou outros especialistas na matéria, que traz à superfície conhecimento que não está escrito em mais lado nenhum; 13 descreveram testes práticos (play testing), em que pessoas que conhecem o produto mas não escreveram a documentação a seguem de ponta a ponta para encontrar aquilo que quem escreve está demasiado perto para ver, sobretudo em tutoriais; e 25 descreveram como pouco fiáveis os comentários de revisão gerados por LLM, em parte porque o contexto de que uma revisão precisa está em sistemas internos confidenciais que não podem partilhar com os fornecedores de modelos. Os redatores relatam que não têm autoridade para impor uma revisão e têm de a negociar. É um estudo qualitativo de práticas autodeclaradas; um dos autores trabalha numa empresa que vende modelos de linguagem.

Uma ferramenta é usada em grande escala em trabalho real e isso está medido, e quem decidiu usá-la foi a pessoa que trabalha, não quem emprega. É mais do que um registo de capacidade — o trabalho é real, não uma demonstração — e menos do que um de implementação, porque nenhum empregador a pôs em produção, nem a exigiu, nem construiu um processo à sua volta. Ponderada como `cautious`: `automating` significa que a máquina consegue fazer a tarefa E que há sinais de adoção, e isto é um sinal de adoção; mas o uso pode ser experimental, e boa parte da medição vem de uma parte com interesses, por isso um registo nunca chega e dois independentes chegam. Repara também em quem está a contar. A telemetria de um fornecedor vê isto diretamente e ao mesmo tempo vende a ferramenta, por isso um registo deste tipo declara esse interesse no seu âmbito; uma agência estatística que pergunta às empresas se os seus trabalhadores usam IA em tarefas vê o mesmo canal sem interesse nenhum, e onde exista é a melhor fonte.

A orientação da FDA para fabricantes de dispositivos médicos, assinalada como contendo recomendações não vinculativas. Abrange a rotulagem, incluindo instruções de utilização, manuais do utilizador, folhetos incluídos na embalagem e guias de início rápido, e diz que os testes de validação de fatores humanos podem avaliar a adequação das instruções de utilização, mas apenas no contexto de utilização do dispositivo; que a consideração mais importante quanto aos participantes nos testes é que representem a população de utilizadores previstos; e que, se os testes mostrarem erros de utilização em tarefas críticas, afirmar que o risco foi mitigado alterando as instruções ou outra rotulagem não é aceitável sem dados de teste adicionais que mostrem que a alteração resultou. Aplica-se apenas a dispositivos médicos e não diz quem escreve as instruções.

Uma falha, um recuo, uma regulação ou um custo estão a travar a adoção. Pode baixar uma avaliação ou alargar a sua incerteza.

Lido artigo a artigo no portal do Ministério da Legislação Governamental, na versão em vigor desde 21 de julho de 2026. Dois números do artigo 34(1) tocam esta ocupação e fazem coisas diferentes. O número 2 exige a quem opera que estabeleça e execute um plano para explicar, na medida em que seja tecnicamente possível, o resultado final que a IA produziu, os principais critérios usados para lá chegar e um resumo dos dados de treino usados para a desenvolver e operar. O número 5 exige a redação e a conservação de documentos pelos quais o conteúdo das medidas de segurança e fiabilidade possa ser verificado. O primeiro rege o que uma referência tem de cobrir; o segundo retira a discricionariedade de deixar algo de fora. O artigo 36(1)(3) põe depois a questão da manutenção e não da autoria: quem opere a partir do estrangeiro acima dos limiares de utilizadores ou de receita tem de designar um representante nacional cujos deveres incluem apoiar o cumprimento do artigo 34(1), incluindo expressamente verificar se esses documentos estão atualizados e exatos. Dois limites. A lei deixa o detalhe ao Decreto Presidencial e a um aviso ministerial, e o artigo 34(2) diz que o ministro pode recomendar o cumprimento desse aviso, pelo que a concretização do que tem de ser escrito não fica fixada por este registo. E vincula apenas quem opera IA de alto impacto na Coreia; nada aqui conta um redator técnico, um documento ou uma hora.

Uma regulação, um subsídio ou uma compra pública estão a exigir ou a financiar a adoção: o espelho de uma restrição. Mostra que a adoção está a ser exigida, não que tenha acontecido, por isso um mandato nunca chega sozinho; dois independentes chegam.

Representativo à escala nacional, período de referência de novembro de 2025 a janeiro de 2026. Esta é a camada de tarefas dos trabalhadores do mesmo suplemento e não a sua camada de adoção por empresa: 23% das empresas (41% ponderado pelo emprego) reportam trabalhadores a usar IA em tarefas do trabalho e, entre as tarefas reportadas, lideram a escrita, a análise de documentos e a procura de informação. É uma contagem de empresas que reportam uma tarefa, não uma medida de quanta escrita é feita assim, e não distingue a documentação técnica de qualquer outra escrita: ninguém perguntou o que foi escrito. O seu valor aqui está no que não é: ao contrário da telemetria de um fornecedor, isto é uma agência estatística a contar o mesmo canal sem interesse na resposta, o que a torna a melhor fonte para a adoção pelos trabalhadores onde existe.

Uma ferramenta é usada em grande escala em trabalho real e isso está medido, e quem decidiu usá-la foi a pessoa que trabalha, não quem emprega. É mais do que um registo de capacidade — o trabalho é real, não uma demonstração — e menos do que um de implementação, porque nenhum empregador a pôs em produção, nem a exigiu, nem construiu um processo à sua volta. Ponderada como `cautious`: `automating` significa que a máquina consegue fazer a tarefa E que há sinais de adoção, e isto é um sinal de adoção; mas o uso pode ser experimental, e boa parte da medição vem de uma parte com interesses, por isso um registo nunca chega e dois independentes chegam. Repara também em quem está a contar. A telemetria de um fornecedor vê isto diretamente e ao mesmo tempo vende a ferramenta, por isso um registo deste tipo declara esse interesse no seu âmbito; uma agência estatística que pergunta às empresas se os seus trabalhadores usam IA em tarefas vê o mesmo canal sem interesse nenhum, e onde exista é a melhor fonte.

A tarefa que antes te contratava, produzir a referência, é a tarefa de escrita mais exposta deste sítio. A que agora escasseia é aquela para que ninguém contrata diretamente: ser a pessoa que não sabe, segue as instruções e encontra o passo impossível. Torna isso visível na forma como trabalhas, porque é o único argumento que sobrevive à redação barata.

A tua equipa vai ser medida por cobertura, e a cobertura acabou de ficar de graça, por isso a métrica vai parecer excelente enquanto a documentação piora de uma forma que não se vê de painel nenhum. O número que vale a pena pôr à frente de um responsável são os pedidos de suporte das dez páginas mais lidas, porque é a única medida que mexe quando a documentação é mesmo boa.

Refazer o posto

Passa formalmente a ser o primeiro utilizador

A única entrada de documentação que um modelo não consegue ter é a experiência de estar baralhado, e uma equipa que publica depressa precisa de alguém cujo trabalho é baralhar-se de propósito antes dos clientes.

Movimento lateral

Passa para documentação que é um artefacto de conformidade

Nas áreas reguladas o documento é exigido por uma norma (a lei da IA da Coreia obriga os operadores de alto impacto a redigir e conservar documentos que comprovem as suas medidas de segurança), por isso quem o segura é a lei e não o orçamento.

Redigir a referência é a tarefa de escrita mais exposta deste sítio, porque a fonte de verdade é legível por máquina e o formato de saída é fixo, e os geradores de documentação já tinham levado uma parte muito antes dos modelos. O que não se mexe é o teste: seguir as tuas próprias instruções numa máquina limpa e encontrar o passo que é impossível para toda a gente que não seja quem programou. Um modelo treinado sobre o código herda precisamente o saber que tem de faltar para esse teste funcionar.

Nenhuma data. O sinal é por que é que a tua equipa é medida. Se for páginas publicadas ou cobertura, a métrica acabou de ficar de graça e vai parecer excelente enquanto a documentação piora, e as decisões de efetivos são tomadas a olhar para esse painel. Repara se alguém acompanha os pedidos de suporte das páginas mais lidas, porque é a única medida que mexe quando a documentação é mesmo boa, e existir ou não diz-te como vai correr o próximo orçamento.

Deixou de ser no momento em que gerar ficou barato, e essa é a mudança mais importante desta ocupação. A cobertura mede agora quanto texto existe e não se alguém consegue fazer alguma coisa com ele, por isso uma equipa julgada por cobertura será premiada por abandonar a tarefa que acabou de se tornar a importante: decidir o que não se escreve. Se a tua equipa ainda reporta cobertura, levantar isto vale mais do que escrever outra página.

Substancialmente, e é o exemplo mais claro desta página de uma tarefa segurada por algo que não é o custo. Em dispositivos médicos as instruções são avaliadas pela forma como utilizadores representativos usam o dispositivo, e as orientações da FDA dizem que corrigir um problema de utilização reescrevendo-as não é aceitável sem novos dados de teste, o que significa que o trabalho não pode simplesmente ser gerado e publicado. Isso é uma proteção de política e não técnica (dura exatamente o que durar a norma), mas hoje é real.