A Importância da Documentação Acessível para IA
A CTO da DX, Laura Tacho, afirma que empresas estão perdendo oportunidades ao não produzirem documentos internos que sejam facilmente compreensíveis por Inteligência Artificial (IA). Em entrevista ao Business Insider, Tacho destacou que a documentação é um ponto crítico para a eficiência das organizações e defendeu a necessidade de políticas que atendam tanto a humanos quanto a máquinas.
Documentos Legíveis Aumentam a Produtividade
Tacho enfatizou que a documentação corporativa muitas vezes é uma “neblina confusa” de memorandos, apresentações e treinamentos em vídeo, o que dificulta o entendimento. "Materiais de treinamento devem ser apresentados em formato de texto, para que possam ser lidos com facilidade por modelos de linguagem", explica a CTO. Essa adaptação é especialmente benéfica para desenvolvedores, que podem usar editores de código baseados em IA, como o Cursor, para processar rapidamente suas documentações.
Desafios da Documentação Visual
A CTO observou que documentos elaborados com foco humano frequentemente incluem elementos visuais que a IA pode não interpretar corretamente. Tacho sugeriu que todas as imagens sejam acompanhadas por descrições textuais, semelhante ao que plataformas de redes sociais fazem ao fornecer textos alternativos para acessibilidade. Ela argumenta que facilitar o acesso aos documentos é fundamental, especialmente para aqueles que não podem perceber as informações visualmente.
Estratégias para Melhorar a Documentação
Tacho propõe algumas estratégias para tornar a documentação mais acessível: uma delas é centralizar os documentos, o que não só facilita o acesso para as IA, mas também melhora a experiência do trabalhador humano. Ela descreveu uma abordagem que utiliza o termo técnico "defrag", sugerindo que as empresas organizem seus documentos, que muitas vezes são criados de forma fragmentada.
Caso de Sucesso e Expectativas Futuras
Outras empresas já estão implementando essas mudanças. Em suas publicações, Lee Robinson, ex-VP de Experiência do Desenvolvedor da Vercel, destacou que a empresa começou a incorporar comandos cURL em sua documentação, substituindo instruções que antes pediam cliques. Tacho acredita que, assim como a Vercel, mais empresas se adaptarão para tornar suas documentações mais legíveis para IA. Ela revelou que engenheiros gastam, em média, mais de 30 minutos por semana buscando informações que não conseguem encontrar. "Quando consideramos o tempo desperdiçado devido à má documentação, percebemos que isso se torna um problema crítico para os negócios," finalizou Tacho.
