Redator técnico / engenheiro de documentação

A referência da API, a tabela de parâmetros, a nota de versão, a entrada do registo de alterações: documentação cujo conteúdo é determinado pelo código.

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.

Escolher que vinte por cento da superfície fica bem documentada, e recusar o resto.

Descobrir qual das cinco pessoas sabe porque é que aquilo se comporta assim, e arranjar quinze minutos do tempo dela para saber.

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 tem forma prescrita e uma pessoa nomeada que o atesta, 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, aviação e processos farmacêuticos o documento é um artefacto de conformidade: a sua forma está prescrita e uma pessoa nomeada atesta-o, 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.