LO
Adoção por quem trabalhaAutomatização cognitiva2026-08-26
Entrevistas a 31 redatores técnicos concluíram que a documentação depende da revisão técnica feita por engenheiros e de pessoas de fora que a testam de ponta a ponta, e 25 consideraram pouco fiáveis os comentários de revisão gerados por LLM
Redator técnico / engenheiro de documentaçãopágina da profissão →
Data do facto / publicação
2026-08-26
Categoria da prova
Adoção por quem trabalhaUma 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.
Tarefas sobre as quais incide
Usar mesmo aquilo que estás a documentar
Seguir as tuas próprias instruções numa máquina limpa e encontrar o passo que era óbvio para quem programou e impossível para todos os outros.
Continua a ser levada por uma pessoa✓ Com prova
Arrancar a resposta a um engenheiro
Descobrir qual das cinco pessoas sabe porque é que aquilo se comporta assim, e arranjar quinze minutos do tempo dela para saber.
Continua a ser levada por uma pessoa≈ Inferência da plataforma
Onde é que isto se aplica
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.
O que isto significa
Quando redatores experientes descrevem como a documentação fica de facto boa, destacam-se dois passos: alguém da engenharia a verificá-la e alguém que não a escreveu a tentar usá-la — e a maioria diz que a revisão de um modelo não os pode substituir, porque não consegue ver o que falta. É das partes sociais e práticas deste trabalho que vem a qualidade.
O que ainda não mostra
Entrevistas sobre práticas, e não medições; não mostra com que frequência as equipas ainda financiam estes passos, nem se estão a ser cortados.
O que podes verificar
Abre o arXiv:2608.26232 («A Second Set of Eyes») e procura «An LLM can only act on positive matches in my experience».
Muda a avaliação?
Não. O índice de impacto nunca é movido por um único facto. Dos 2 juízos ligados em cima, 0 passaram de inferência a prova com este registo; os outros 1 já se apoiavam em prova anterior.
Fonte
Avinash Bhat, Ian Arawjo, Disha Shrivastava, Jin L.C. Guo (McGill, Université de Montréal, Google DeepMind) — "'A Second Set of Eyes': The Process and Challenges of Software Documentation Review", arXiv:2608.26232v1 (26 August 2026) · verificado 2026-09-28 · Claude (VOLO agent) · interpretado 2026-09-28 · Claude (VOLO agent)
Fonte primária: publicada pela parte que fez isto, ou pela autoridade de referência. Não precisa de coassinatura.