O Escritor Técnico Nativo de IA

A IA está mudando mais do que a forma como os escritores técnicos redigem conteúdo. Está remodelando como pesquisamos, criamos, estruturamos, revisamos, mantemos e medimos a documentação, enquanto muda o papel do próprio escritor técnico. Este meetup irá explorar maneiras práticas como os escritores técnicos estão incorporando a IA em seus fluxos de trabalho, desde ferramentas e habilidades de documentação baseadas em IA até novas abordagens para organizar e manter conteúdo. Palestrante Confirmado Ane Tröger, PhDEscritora Técnica Principal na BayerPalestra: Construindo uma Habilidade de Classificação Diátaxis para Docs-as-CodeDescrição: Em repositórios internos de docs-as-code, a documentação tende a crescer organicamente, em vez de por design. As páginas são adicionadas onde for conveniente, em vez de onde pertencem, e o resultado é uma estrutura plana e não tipada que ninguém entende completamente. Migrações de plataforma pioram isso: qualquer hierarquia que existia antes colapsa parcialmente, e o conteúdo chega em um lote. O custo recai sobre todos — os leitores perdem tempo no modo errado, os escritores perdem a confiança sobre onde suas contribuições vão, e as ferramentas de IA perdem precisão porque sinais mistos produzem resultados mistos. Uma possível solução é reestruturar o repositório para que seja mais fácil encontrar informações, mais fácil manter e potencialmente mais fácil para a IA consumir. Esta palestra aborda a construção de uma habilidade de IA que classifica páginas de documentação de acordo com a estrutura Diátaxis — tutorial, como-fazer, explicação e referência — além de um quinto tipo, navegação, adicionado para lidar com os hubs de navegação que todo repositório real contém. Vamos ver como a habilidade é estruturada em três arquivos, o fluxo de trabalho de quatro etapas que segue (ler, classificar, dividir, navegar) e por que produz um nível de confiança a partir da distribuição de sinais em vez de um veredicto de aprovação/reprovação — com baixa confiança atuando como a bandeira de conteúdo misto. Adequado para escritores técnicos em qualquer nível; seções sobre design de habilidades e tomada de decisão vão mais a fundo para praticantes experientes. As fundações da estrutura Diátaxis e exemplos serão cobertos brevemente, e se você quiser aproveitar ao máximo esta palestra, sugiro que dê uma olhada na estrutura Diátaxis com antecedência: https://diataxis.fr/start-here/ Frances LiuCo-fundadora, Promptless Palestra: O que os agentes de IA erram ao escrever docs Descrição: Testamos regularmente agentes de fronteira (Claude Code, Codex e OpenCode com modelos abertos) em tarefas de documentação. Os rascunhos geralmente retornam polidos e coerentes, mas suas falhas ocorreram antes da redação: decidir se uma mudança precisava de documentação, descobrir para quem eram os docs, escolher em qual página a mudança pertencia, e responder o que o leitor precisava fazer em vez de descrever o que a funcionalidade faz. Vamos analisar quais agentes se saem melhor em quais tipos de tarefa, que contexto aumenta suas chances de sucesso e como revisar sua produção para que as falhas silenciosas não cheguem aos seus leitores. Você sairá com uma lista de verificação para decidir o que passar para um agente e o que verificar quando ele devolver o trabalho.Helena JerneyChefe de Experiência da Informação na StreetLight Data Palestra: Arquitetura da informação para o público de IADescrição: O que é necessário para que o conteúdo seja consumido pela IA para possibilitar uma experiência ótima do usuário. Onde a arquitetura de conteúdo e contexto se cruzam e como gerenciar o pipeline de informações para atender às necessidades e limitações dos LLMs. Mais detalhes em breve.